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A happy QLing new year to you all 
And especially to our merry (not too 
merry | hope!) band of regular contri- 
butors, thank you all for your hard 
work for QL Today, where would | be 
without you? And thanks to Jochen 
Merz too - although my name appears 
in lights in this magazine, Jochen is the 
hardest working of the pair of us, | 
hope readers appreciate his hard work 
in laying out the magazine and getting 
it printed. 


Looks like we'll have a pretty exciting 
year ahead. Negotiations on the sale of 
the Q40 have been concluded, it has 
an operating system, now all it needs is 
customers, and I'm sure there'll be plen- 
ty, especially when people learn that 
Tony Tebby is using one as one of his 
main computers! 


| got a MinisQL for Christmas (just!) and 
after the problems | had with the tower 
cased Aurora before it, I'm glad to say 
that the same Aurora board works 
well in my MinisQL system, so full 
marks to Aurora, while everything 
else around it was on the blink, it 
Stayed in one piece and worked 
better than ever in the final system. 
Paragraph, the new pointer driven 
wordprocessor is out (report in this 
issue), a new version of QemuLator 
and a trial version of QPC2 are out, 
and the colour drivers (in the guise of 
SMSQ/E 3) should be with us before 
not too long, rumours continue of 
work being done in Austria on the 
basic software required for internet 
access, the new Turbo Toolkit is out 
(see below) and plenty of other things 
are happening too! 


OOPS - Iwo significant errors got 
through the net in the last issue, we 
got the date of the Croatian meeting 
wrong (it should have been Decem- 
ber) and! also got the name of Chris- 
topher Cave’s file viewer program 
wrong - | called it Mlext whereas its 
real name is MView. Apologies to all 
concerned. 
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Dilwyn Jones 


The next issue will, | hope, see another 
cover disk with the magazine. Let's 
hope | make a better job of that! One 
of the things we hope to include on it 
is the new freeware release of Turbo 
Toolkit thanks to the hard work of 
Mark Knight and David Gilham. 


And speaking of the next issue, I'd love 
to receive a few more articles from 
you the readers for publication. If 
you've used a nice little program or 
new piece of hardware, write and let 
the other readers know about it. 
Equally, if you'd like to offer comment 
via the letters page, or pass on some 
hints and tips or short, useful listings, 
we'd love to hear from you. We are a 
little short of material for the next issue 
as | write so please do write in with 
your contribution on floppy disk or by 
email, the readers would love to hear 
from you! 
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NEWS 


RWAP Software 

(Rich Mellor) 

| have now been able to re- 
lease vi.5 of Deathstrike which 
is yet another game formerly 
sold by Talent Software. This is 
a clone of the classic arcade 
game Scramble, in which you 
control a space ship as it 
travels through an alien base, 
destroying as much equipment 
as possible in the search for 
the mothership. This is a 
colourful and fast version which 
will now work on all versions of 
the QL {although | have noticed 
that the game does not seem 
to work with a SuperHermes 
keyboard for some reason). 

| can now also supply a wide 
range of IBM Compatible PCs 
and components _ (including 
monitors, mice and printers) at 
competitive prices, and should 
be able to ship them with QPC 
ready installed if required. 


PROGS 


Joachim Van der Auwera sent 
uS an email suggesting we 
point out that ProWesS users 
who have Web access can get 
an update from his Web site at 
http://www.iriathlon98.com/ 
PROGS/ 

This may prove useful informa- 
tion for ProWesS users who 
are trying to get early versions 
of the new word processor 
Paragraph working, for exam- 
ple, as that reportedly requires 
up to date versions of Pro- 
WesS to work correctly. 


QemuLator V1.1 

A new release of Q-emuLator 
for Windows (version 141) is 
available at the Q-emuLator’s 
web site: 
http://www.geocities.com/Sil 
iconValley/Heights/1296/q-e 
mulator.htmi 


The two most relevant new 
features are support for sub- 
directories in the file system 
and read-only access to 
QXLWIN files. Graphics speed 
has been improved, the maxi 
mum QL RAM amount has 
been increased to 16 MB, and 
for the first time a QL ROM ts 
included in the Q-emuLator 
package, though it doesn't 
work with more than 768K of 
QL RAM. (lt is a Minerva 1.89 
ROM image, now public do- 
main). 

Another interests feature is 


porary 
registra- 
tion 
codes 
are now 
freely 
available: | 
if you are 2 
not yet a 
Q-emu- 
Lator 
regis: 
tered 
user but | 
you want 1D hembeud bin ie 
to try the {Dircextsbi 2 
unlimited 4 
version 
of 
Q-emuLator just ask to the 
author by email (the address is 
danielet@geocities.com) and 
he will send to you a free tem- 
porary registration code that 
will last for about two weeks. 
Be sure to include your full 
name in your request. 
Work has already started on 
Q-emuLator version 2, that will 
have a faster and full screen 
QL display. 
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Jonathan Hudson 

In the last two months the 
following **free** packages 
have been uploaded to 

www.jrhudson.demon.co.uk 
perl4qdos: Port of perl to 
QDOS. perl 4 rather than perl 5, 


alas. Package contains binary, 
documentation, source code 
and many examples. Examples 
are mainly QDOS specific and 
the port adds support for many 
specific QDOS features, includ- 
ing the graphics traps. 

A comprehensive (10 page) ar- 
ticle on perl4qdos will be pu- 
blished in Quanta, January 
1999. The article will also be 
available as HTML from 
www.jrhudson.demon.co.ukin 
Jan 99 for non-Quanta mem- 
bers. 


fight.bmp 


a right.gif 


wxqltools GU! package under 
Windows (95,98.NT) or Unix to 
read and write QDOS floppies 
under foreign operating sys- 
tems. This program is a graphi- 
cal front end to qltools. 
gdbm173: The GNU database 
manager GNU dom is a library 
of routines that manages data 
files that contain key/data pairs. 
The access provided !s that of 
storing, retrieval, and deletion 
by key and a non-sorted tra- 
versal of all keys. Source, docu- 
mentation, c68 library, exam- 
ples in perl and 'C’. 

nroff: nroff port for QDOS. 
Converts Unix man pages and 
other nroff format files to text. 
Includes man and ms macro 
packages. 
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catdoc: Converts catdoc con- 
verts MS Word documents (inc 
Word 97) to text. Archive con- 
tains executable, source and 
documentation. Ported from 
unix catdoc program of Victor 
Wagner 

unzip540xQ: unzip 5.40. Binary 
and documentation. Source 
code available ~—— from 
ftp.cdrom.com The QDOS 
version is provided (experimen- 
tally) as a self extracting object 
file. 

LRESPR unzip540xQ.obj 

And follow the on screen in- 
structions. 


Dutch Thesaurus now 


available 

JUST WORDS! has released a 
Dutch language thesaurus. The 
program is pointer driven and is 
based on the popular English 
QL-THESAURUS. It has a data- 
base of 13,500 words and phra- 
Ses. 

NL-THESAURUS costs fl. 20,-- 
or £7. Payment can be made in 
guilders by direct transfer to 
Netherlands Postbank number 
4111942 (GI Wicks) or by 
Eurocheque in pounds. 

JUST WORDS! is preparing a 
series of freeware dutch lang- 
uage dictionaries in QTYP and 
SPELLCHECKER formats con- 
forming to the latest spelling 
rules. Dictionaries of 52,000 
and 70,000 words are currently 
available, and a larger dictiona- 
ry should be available in the 
new year, 

Geoff Wicks, 28 Ravensdale, 
Basildon, Essex, United 
Kingdom. Telephone — from 
Belgium and the Netherlands 
00 44 1268 281826 


Turoo Toolkit V3097 

Mark Knight and David Gilham 
have now released version 
3027 of the Turbo Toolkit as 
freeware. QL Today hopes to 
distribute a complete copy on 
our next cover disk and it 
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should also be available from 
the usual sources of QL free- 
ware. Below you will find the 
major list of changes for this 
version. 

This version has been pro- 
duced by disassembling the 
last official version (v3.22). Inter- 
estingly, only 7 significant bugs 
were found and contrary to po- 
pular opinion, no direct system 
variables access etc were 
found. 

It has been tested with QL 
ROM versions from AH up to 
SMSQ/E {on a_ variety of 
hardware platforms). Mark says 
that some Turbo compiled pro- 
grams which failed on modern 
systems may now work with 
this new toolkit. 

Keywords updated — include 
TYPE_IN, ALLOCATION — and 
DEALLOCATE, COMMAND_LINE, 
SET_PRIORITY = COMPILED. 
The latter now even works 
with QLiberator 

New keywords added include 
LONGINTEGER (converts a 4 
byte string holding an integer 
value to a long word) and 
LONGINTEGERS (converts a 
long word intoa matching 4 
byte string), both useful for 
when you need to store 32 bit 
long words in strings or directly 
in memory. POKE_F pokes a 6 
byte representation of a float- 
ing point number into memory. 
FWINDOW% helps with hand- 
ling hirresolution screen win- 
dows - it is a function which 
returns an error code number 
making error handling easier. 
The file of demonstration basic 
program listings (DEMOS_bas) 
has also been slightly updated 
to use the SYS_VARS function 
to access system variables ra- 
ther than hard coded addres- 
ses, for example. 

The distribution includes a pro- 
gram to patch startup code in 
Turbo compiled programs, to 
try to make some older pro- 
grams work on modern plat- 
forms. It contains code written 


by Davide Santachiara to patch 
among other things two hard 
coded system variable acces- 
ses in the startup code for older 
Turbo compiled programs. 
Turbo Toolkit can now be used 
with QLiberator In addition, it is 
possible to link it as an SMSQ/E 
module for those who know 
about such things. Since the 
toolkit is freeware, the old 
runtime version (RUNTIME_EXTS) 
Is No longer required - you can 
simply include a free copy of 
the toolkit iiself with software 
sold or given away! 


QBranch News 

The Q40 should be available 
from the end of January - 
middle of February, The product 
will cost 350.00 UKP and this 
will include 16Mb Ram (upgrad- 
able to 32Mb) and the |/O card. 
All the end user will need is a 
case, keyboard, floppy /hard 
disk, monitor and mouse. No 
QL chips or other hardware is 
required. The system will be 
shipped with the QDOS classic 
system on board. SMSQ/E for 
the Q40 Is nearing completion 
and will cost extra although 
there will be discounts for 
existing SMSQ/E users. The 
price may be reduced if we can 
obtain lower priced 68040 
chips than those currently quo- 
ted. 

TF Services are currently look: 
ing into other boards to plug 
into the ISA slots and an ISA 
Slot extender. 

Masterbase, the pointer driven 
front end for DBAS should be 
available for release soon. This 
will be supplied on two floppy 
disks with one containing tne 
latest DBAS Public domain 
release. 

Possible visitors to the Hove 
show include Zeljko Nastasic 
and Peter and Klaus Graf 
Jochen Merz will definitely 
attend. Masterbase, Q40 and 
QD 98 will be demonstrated 
there. 


Extra: We are asking people to 
place firm orders for the Q40 
because this is an expensive 
product and we would like to 
have at least part of the money 
guaranteed before we embark 
upon it. The first 25 people to 
send us Cheques or credit card 
details will receive free system 
upgrades and a reduced price 
on SMSQ/E when it is released. 
No cheques will be cashed or 
Credit cards debited until we are 
ready to ship the first units but 
just having the pledge of cash 
will make us feel more secure. If 
the final price is lower than that 
quoted then we will refund the 
difference. 


Z88 News 


Alchemist Research have sent 
us a copy of a CD-ROM called 
Z88 Heaven which contains 
over 1,000 Z88 programs and 
Z88 emulators to run on the PC. 
As many QL users also use a 
288, we decided this may well 
be of interest to our readers. We 
would also be interested to hear 
from anyone willing to review 
this CD-ROM for us. 


The CD-ROM contains the entire 


collection of the Z88 User 
Group Software Library, and files 
from the United States 788 User 
Group library There are Eprom 
image files and ROM images 
which can be transferred to a 
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Z88 and then programmed into 
an EPROM, the most prominent 
of which is the Z88 Forever Col- 
lection, full of the latest Z88 ap- 
plications. It also includes Win- 
dows 95 utilities, allowing you to 
‘transfer files, read BASIC and 
Pipedream files directly.” 
Finally, the CD-ROM contains the 
Z88 Source Book and several 
very useful articles and guides 
detailing every aspect of the 
Z88. 

The CD will be available from Bill 
Richardson at a price of £15 or 
£12 to Z88 User subscribers. 


Z88 with internal 
expansion 

W.N. Richardson & Co now of- 
fer internally expanded memory 
Z88s with either 128k or 512k 
ram, with OZ4 operating system 
version. This memory replaces 
the internal 32k, consumes 
about the same working and 
standby current, and can be di- 
rectly used by Basic and Pipe- 
dream as workspace as well as 
for normal file storage, though 
the Z88 reserves a little for 
internal use. An upgrade service 
for your exist- 
ing machine is 
also offered. 
See Bills  ad- 
verts for prices. 


JMS 


Quite a lot of 
news this time 
from Jochen 
Merz Software. 
QD98 is” fe 
1 leased (in fact, it 
1 was released in 
| Croatia begin- 
ning of Dec. 
1998 - so the 
name is still OK). 
A detailed de- 
scription of its new features plus 
some screenshots (done with 
QPC 2!) can be found in the JMS 
ad on page 13. 

By the time you read_ this, 
SMSQ/E 2.91 will be released. It 


memory 


has the Euro-Symbol on charac- 
ter code 181, and it will translate 
them to character 164 (this is 
the Euro Symbol! in the cha- 
racter set Latin Q). | think we will 
have a dedicated Euro-article in 
the next issue. (Dietrich Buder 
has done quite a lot of work on 
he Euro, created Download- 
fonts etc., so we can base it on 
his experience). If you want to 
use the Euro, then! suggest that 
you get the new SMSQ/E first. 
Anybody out there who has 
created a download-Euro for 
non-EPSON printers (HP Deskjet 
or Laserjet etc)? Please get in 
contact with QL Today so that 
we can offer a solution for a 
variety of printers. 

Lots of news on the JMS web- 
site: 
http://www.j-m-s.com/smsq/ 
You can see information about 
the new QD98 if you want to 
see it in colour 

Follow the link to Marcel Kilgus 
homepage: you can download 
an alpha version of QPC which 
works and supports most fea- 
tures but for serial port, parallel 
port and writing to flp and win 
(but it's a demo, so it will never 
do this anyway in the demo), 
Why not give it a try, you can 
now switch between QPC 2 and 
other Windows — applications 
without having to reset the ma- 
chine - similar to the way you 
switch between jobs in QDOS. 
Have a go, if you encounter 
problems, tell Marcel, otherwise 
enjoy it! 

The QL News List is working 
again. | am using a different pro- 
vider who double-checks that 
you want to get in the list by 
sending a reply email to your 
subscription which you have to 
return - email addresses have to 
match, of course! Subscribe via 
my website. If you have email 
access only, then send an email 
to ‘add2qinews@j-m-s.com’ 
and | will add you manually 

lf anybody needs bulk DD disks, 
please contact me, I've got 
masses. 

= 
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The right EPSON printer - a 
perfect add-on for the QL! 


R.S.RThain 


It comes to us all sooner or 
later In January 1998 my Oli- 
vetti 24-pin dot-matrix colour 
printer began giving trouble. 
First of all, my usual suppliers 
told me that they were no 
longer stocking colour ribbons 
for it - insufficient demand. 
After looking around | got black 
OEM ribbons. Maybe — the 
printer resented this indignity, 
for a month or so later it 
became temperamental, refus- 
ing to move to the start posi- 
tion, or to let me examine or 
reset the defaults. After some 
struggling | decided to retire it. 
Half-remembering dire warnings 
in QL TODAY and QUANTA 
magazine about modern prin- 
ters vis-a-vis QLs | searched 
my old copies for guidance. It 
was not altogether successful, 
but | did come up with a state- 
ment by Jochen Merz that the 
Epson 600 and 800 series 
should be all right. 

So | went to the local com- 
puter supermarket which as 
usual was having a Sale, and 
looked at their printers (20% 
off). It was a bit disconcerting 
to find that the Epson 800 had 
been replaced by the 850. Had 
it been “dumbed-down’? After 
a talk with the assistant (helpful, 
but | don't think the problem 
really registered) | decided 
“probably not’, and returned 
home £279 poorer with a very 
large cardboard box. [Editor: 
as far as | know, the main 
difference of the 850 is that it 
is even faster than the 800 - 
and | am very happy with the 
high speed of the 800! 

| use a QL with Super Gold 
Card (upgraded by Qubbesoft 
in the middle of all this to an 
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Aurora), and a QXL2 in a 386DS 
PC, both with SMSQ/E. The old 
printer was operating in 
LQ2550 mode. My communica- 
tions with it were with Printer- 
master (an excellent program 
for ad hoc control), or with the 
Xchange drivers, or in some of 
my programs by commands 
issued directly from SBASIC. | 
also used SDUMP auite a lot 
(printing movement cards on 
160 gsm paper for a local 
Bridge Club), but the Olivetti 
had trouble with this and | kept 
my original printer - a 9-pin 
Shinwa clone. GPRINT-prt was 
unsuccessful also, so that | 
could never make a print from 
EASEL. 

| have just finished testing all 
these with the new printer To 
my delight they functioned per- 
fectly without modifications to 
programs or even to the para- 
meters of SDP_SET! 

GPRINT_prt makes tasteful, if 
somewhat pale, grey-shaded 
prints of my graphs, filling the 
whole width of the paper [Use 
Jochen’s filter 24-program 
(available free on his BBS) 
which converts greyish 9-pin 
dump output to perfect 24-pin 
output! Incidentally, | have tried 
using SDUMP to get colour 
prints from EASEL. It works, but 
you also get EASEL’s borders, 
the buttons, and whatever else 
happens to be on the 640x320 
screen. | am indebted to the 
splendid SBASIC/Superbasic 
Manual by Rich Mellor and 
others for the information 
(which I'm sure | ought to have 
known) that SDUMP can be 
used to print a specific part of 
the screen, but | have to do 
that from basic, and as soon as 


you enter basic, eg from a 
Hotkey, EASEL vanishes! [Set it 
on a HOTKEY - we'll show 
you in the next issue how it 
works!] | tried reducing the 
screen, but, as the Manual 
says, SDUMP stays with the 
original screen size, and you 
get items in the dump which 
were invisible on the screen! 
So that is something | have 
given up for the time being. As 
a final test, | tried downloading 
the QLQ fonts {another thing 
that the Olivetti did not do very 
well). The results were excel- 
lent. 

As one might expect, the 
print quality is better than that 
of the 24 pin printer, which itself 
was pretty good. It seems 
strange to be using cut sheets 
instead of fan-fold paper and 
even stranger that instead of 
being able to read every line as 
it is printed, the paper disap- 
pears into the printer and 
emerges after a while with the 
print upside-down. = When 
switched on, the printer some- 
times makes mysterious noises 
for a time before giving the 
go-ahead, but that can be borne. 

The printer Manual inevitably 
devotes most of its generous 
space to PC’s and Macs. It 
does, unlike a  600-series 
Manual | looked at, give a list of 
all the control codes that the 
850 will accept; but doesn't say 
what they do! Provided you are 
content with dot-matrix capa- 
bility and are familiar with the 
old Epson codes it can be 
used without further documen- 
tation; but the 850 can of 
course do much more - extra 
fonts, some of them scaleable, 
very precise positioning of the 
printing, and several esoteric 
routines for high resolution 
graphics. And so | bought the 
ESC/P2 Reference Manual for 
£43.26 including next-day 
delivery from Unicomp Ltd 
(01732 780303). 
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This weighty volume (nearly 
3.5lbs), dates from 1994, and 
therefore has almost no refe- 
rences to ink-jet printers, ex- 
cept in parts, mainly graphics, 
which have been revised since. 
But it is no less useful for that. 
n addition to an exhaustive and 
illuminating description of all the 
control codes used by Epson 
printers since the beginning, it 
includes a series of essays on 
subjects such as “Set the 
printing area’ which | read with 
great fascination and_ partial 
understanding. 

I'll try to implement some of 
this as time permits, but for 
now that's about it. The printer 
weighs 14.3 lbs, has a footprint 
(when shut down) © of 
18.7x10.7in. (475x274 mm). The 
paper support adds about 5in. 
to the depth. Cartridges cost 
about £16 (black) and £18 
(colour). According to the 
Manual, at 360 DPI a black 
cartridge will print 900 A4 
sheets, and colour 300. Prices 
are for Epson cartridges: "com- 
patible’ ones seem to cost 
between £7 and £11, but I'll stay 
with Epson while the machine 
is under warranty. 

Editor: I'm glad to read that 
some people follow the advice 
and are very satisfied with the 
result, You will find more 
details about the very recent 
cheaper model Stylus Color 
740 in the “Letter Box" 
section of this magazine. 

EPSON Germany can pro- 
vide special add-on pages (3 
sets) for the three generations 
of EPSON ink colour printers - 
you should be able to get 
them from EPSON UK too if 
you bought the ESC/P2 Refe- 
rence Manual. Provided, 
enough interest exists, | can 
dig out the old filter24 and 
explain it in the next issue. It 
takes 9pin-EPSON output and 
prints it on 24pin printers in 
solid colours, unstrechted. 
| 
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Kan U Spel Uzing Yore QL? 


Geoff Wicks 


The last issue of QL- Today 
contained a review of my free- 
ware program ‘Spelling-Crib’. 
Most people tell me | should 
have added it to my program 
range and charged a fiver, but | 
preferred to make it public 
domain. The program was 
quick and simple to write, main- 
ly because it uses routines 
from existing programs, and | 
wanted to use it to encourage 
discussion on QL spelling aids 
and spellcheckers. | also had 
the less altruistic motive of 
reaching QL users who have 
not bought my programs. Every 
time they use Spelling-Crib the 
JUST WORDS! logo and dis- 
tinctive house style will be on 
their screen as a free adver- 
tisement for my software. If 
Adidas and Nike can do it, why 
can't |? 

Spelling-Crid was conceived 
at a workshop when a custo- 
mer suggested the use of 
SOLVIT-PLUS as a help for the 
occasional difficult word. He 
had most of the spelling aids 
available to QL users, but found 
these of limited help. | felt aless 
cumbersome method than he 
suggested would be to com- 
bine a few short routines from 
SOLVIT-PLUS with other rou- 
tines developed for QL-THE- 
SAURUS, and then use the 
Stuffer buffer to link with a 
word processor or text editor 
The program was written and 
tested in about 2 months, al- 
though, as Dilwyn Jones disco- 
vered, it still has a few minor 
bugs. At the moment it uses a 
memory hungry plain text file, 
although | hope to write a ver- 
sion that will use a QTYP dictio- 
nary, 

Many QL users are not happy 
with the current spelling chek- 
kers and aids, but few have 


concrete ideas of what a spell 
checker should do. As | have 
written before in QL Today, 
people have strong personal 
preferences over spell check- 
ing. Some want to check as 
they type, while others want to 
check on completion of a do- 
cument. Some want sugges- 
tions for alternative words and 
others do not. Some want as 
large a dictionary as possible, 
but others prefer a small one. 

The QL has three commer- 
cial and one public domain spell 
checkers. Each has _ its 
strengths and weaknesses, but 
itis only the public domain one 
that can be described as “intelli- 
gent’ in its suggested alterna- 
tives for a misspelt word. 

| know nothing about the 
oldest spell checker “SPELL- 
BOUND", which is rarely used 
these days. The other two 
commercial spell checkers are 
"SPELLCHECKER" and "QTYP’. 
SPELLCHECKER is the dedica- 
ted checker for the word pro- 
cessor Perfection, and al 
though it is possible to use it to 
check text files, it is of limited 
use outside of Perfection. It 
does not provide suggestions 
for a misspelt word, and also 
has some restrictions that limit 
its usefulness for many non- 
English languages. Neverthe- 
less there are many Perfection 
users who are happy with this 
level of spell checking. 

In contrast QTYP is a generic 
spell checker that will work 
with most QL text programs. It 
is not strictly a spell checker 
but a resident extension that 
enables you to incorporate 
spell checking in your own 
programs. Text87 plus 4 users 
can use QTYP in two ways. 
They can either use it in its 
native state for check as you 
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type spell checking, or on 
(part) completion of a docu- 
ment using Text87’s own imple- 
mentation of QTYP spell check- 
ing. 

QTYP works by comparing 
each letter of a word against 
the list of words in its dictionary. 
When a mismatch is found, a 
warning sign goes up. If you 
wish, you can examine a list of 
words for the correct spelling. 
To access a QTYP dictionary 
you need to know the first 
letter or letters of a word. Spell 
“accommodate” as "“accomo- 
date’ and you will quickly find 
the correct spelling using 
QTYP because it is looking for 
the root “accom”. Spell “sur- 
prise’ as “suprise” and you will 
find it hard to discover the cor- 
rect spelling, as QTYP is look- 
ing for a root of “supr’. Spell 
“cinnamon” as “sinnamon" and 
QTYP will be of no help what- 
soever 

Most PC word processors 
have an intelligent spell 
checker, which will suggest 
alternatives for a misspelt word 
including mistakes like 
“sinnamon’. When Spellchecker 
and QTYP were first released, 
the QL was still using a slow 
processor and had a maximum 
memory of under iMB, and it 
would not have been possible 
to have had an intelligent QL 
spell checker. They use lengthy, 
complicated and specially con- 
structed dictionaries containing 
lists of homophones, or words 
which sound the same, but are 
spelt differently such as 
“sauce’ and “source”. 

The QL now has the memory 
and speed for an_ intelligent 
spell checker using similar pro- 
gramming to those on the PC, 
but in practice it is unlikely that 
one will ever be produced. It 
would require a programmer 
with both the time and the spe- 
cific language knowledge to 
construct the dictionary, and | 


QL foday 


doubt if such a person exists. 
There is a further complication. 
Present QL spell checkers use 
simple dictionaries - basically 
they are just lists of words in 
compressed form - and it is 
possible for any QL user even 
if he has no programming skills, 
to write his own dictionaries. 
Both the Italian and Dutch 
QTYP dictionaries were written 
in this way. The dictionary for 
an intelligent spell checker 
would have to be separately 
constructed for each language, 
again by a programmer with 
the necessary language know- 
ledge and time for the task. 

But why should we copy PC 
programming? If we are just 
going to ape what happens in 
the PC world, then we should 
be using PCs. The history of 
the QL is full of innovative and 
creative thinking to solve what 
many once thought were 
insolvable problems. And _ this 
has also happened in spell 
checking. There is an ‘intelli- 
gent’ spell checker for the QL 
that uses different techniques 
from the PC spell checkers. 

This spell checker Suggest 
by Lester Wareham, uses 
QTYP to do its spell checking, 
but in an unusual way. Basically 
the program assumes _ that 
spelling mistakes and typing 
errors have what you might call 
a logical cause. We hit the 
wrong keys on the key board: 
we type two characters instead 
of one or vice versa; we type 
words as they sound and not 
as they are spelt. If Suggest 
comes across a misspelt word, 
it looks through a set of rules, 
and uses these to devise theo- 
retical words the writer could 
have intended to use. It then 
checks these words against 
the words in the QTYP dictio- 
nary, and if they are valid 
words, suggests them as 
alternatives for the misspelt 
word. 


Unfortunately Suggest is not 
bug free. It will not run on all QL 
systems, including the early 
Sinclair ROMs and the Atari TT. 
It does not always replace a 
misspelt word accurately and 
sometimes gives it an extra 
first letter Nevertheless | am 
impressed by the program, and 
especially the innovative and 
creative thinking behind it. It is a 
pity that it was not developed 
further 

In this article | have attemp- 
ted to assess the present state 
of QL spell checking, and 
explain why QL spell checkers 
are limited in their scope. In my 
opinion an_ intelligent spell 
checker for the QL could not 
use traditional programming 
methods, but one could be 
written using the QTYP exten- 
sions on the lines of Lester 
Wareham's Suggest. It may 
even be possible to devise a 
Set of “compromise rules’ that 
would apply to most langua- 
ges, and, if necessary, supple- 
ment these with a short set of 
rules for each specific lan- 
guage. There is, of course, an 
important proviso. In my opinion 
Lester Wareham has a right to 
an intellectual copyright for his 
idea, which should be respec- 
ted. 

| am not one of the elitists 
when it comes to spelling, and 
do not see poor spellers as 
being inferior or lazy. There can 
be many reasons for poor 
Spelling, some of which are 
physical in origin. | would be 
interested in hearing what 
readers of QL loday would like 
to see in a spell checker, or of 
their ideas for other spelling 
aids. | would also be interested 
to hear from programmers who 
have ideas for spell checking 
that they would like to put it 
into practice. 
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What are all these Handshake Lines? - Part 2 


Nastia 


Determining DTE and DCE, quick 


and dirty (out effective) solutions 
As can be seen, correct cabling relies heavily 
on the correct identification of the device type - in 
fact, just about the only way it will work if you get 
the type wrong, is if you get both device types 
wrong and also if all the handshake signals are 
implemented. As can be seen from the size of the 
table above, there is much working against this 
case! The simplest way to determine what type 
the device is, is to look for output signals that 
should be active when the device is powered up. 
Here are some tips: 
e Using a voltmeter to determine device type: 
First of all, disconnect all cables to the port to be 
sure you are measuring signals only at this port, 
not the signals that might be coming from the 
other end of the cable. Take a 3k or thereabouts 
resistor (almost anything between 1 and 10k will 
do just fine) and connect it across the ends of a 
voltmeter (or multimeter set to measure voltage). 
Then, with this resistor connected, check the 
voltage between ground (GND) and the various 
lines. If you measure anything within legal RS 232 
voltages (+3 to +15 or -3 to -15 Volts) you are 
looking at an output signal. Take note of the 
signal name, and use the DIE/DCE comparison 
table at the start of this article to determine what 
the device type is. If you find either RXD, DTR or 
RTS to be outputs, its a DTE, and if you find either 
TXD, DSR or CTS to be output, then its a DCE. 
Remember, it is enough to determine one of the 
three is an output to determine the type of the 
device correctly. In some cases the device in 
question may have to be told to ‘open’ the port in 
software or by an appropriate command (this will 
normally be the case with computers). The best 
candidates to start testing are of course RX and 
TX lines as these are mandatory. They will nor- 
mally be ‘inactive’ if there is no data being sent 
from the device. There are exceptions, however 
and the device described below can help with 
those. 


¢ Building a simple RS 232 indicator: 


1k ohm 


Green 
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The above diagram represents a dirt cheap and 
very simple RS 232C tester the diodes are LED, 
Le. light emitting. The device should be connected 
so that the GND terminal is tied to the serial port 
GND terminal, and the Test terminal is connected 
to each of the RS 232C signals in turn. If a signal 
is an output, the green LED will light up if its active 
and the red LED will light up if it is inactive. If you 
are testing RX or TX lines while data is being 
transmitted or received, the green LED will light 
up dimmer than for other output signals if the port 
is RS 232, and both LEDs will be lit dimly if it is RS 
232C. The respective LEDs intensity will vary de- 
pending on what data is being sent. The device 
can be used instead of a voltmeter or multimeter 
exactly as described above. The device can be 
built inside the plastic parts of an old pen with a 
little care and attention to detail. It is possible to 
get two-color LED diodes that have two opposed 
LEDs in the same package, connected just as on 
the diagram above. Just note that if you use one 
of those, both LEDs lighting will produce an 
orange-ish light. The nice thing about the simple 
device above Is that it does not depend on the 
type of connector used, unlike the device 
described below. 


e A quick and dirty RS 232 breakout box: 


By building a circuit not unlike a 6-fold tester 
described above, a simple RS 232 test box can 
be made. | will leave it to the prospective builder 
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to decide which one of the myriad RS 232 
connectors that are in common use will be 
chosen for this project --) 


e Using an oscilloscope 

When everything else fails, an oscilloscope will 
come in handy. However, | will not delve deeply 
into this subject as anyone that has a ‘scope will 
probably already have ideas about the use of it to 
debug serial ports. Just bear in mind that the data 
on the RX and TX lines is actually inverted with 
respect to the actual bit values, so one should 
expect to see a picture not unlike a flipped over 
diagram given in this article, with start, data, parity 
and stop bits. It does take some tweaking to get 
it on the screen but it is possible. Needless to say 
there are even more specialized devices to 
debug serial ports (some costing on the order of 
a good car}, which just goes to show that QL 
users are not he only ones having serial port 
problems. 


Final word 
You have probably noticed that | haven't even 
attempted to show all the different connectors 


used for serial ports. This data can be found 
elsewhere for the port in question - manuals DO 
really contain useful data once in a while, you 
know! They make the number of possible 
variations even larger but not unmanageable - the 
key, as always is understanding what the signals 
on the ports do. With this knowledge most if not 
all ports can be wired together correctly. | hope | 
have managed to get at least some aspects of 
serial communication explained. This lengthy 
article however is not by far definitive word on 
the subject - in fact, whole books have been 
written about this. Still, | hope that anyone trying 
to connect two stubborn devices using serial 
ports, finds this article of use Dont be 
discouraged if things don't work at first. 
Fortunately, serial ports are very robust and are 
made to be able to survive wrong connections - 
it seems like the creators of the standard knew 
that they are bound to happen. So, may your lines 
be connected properly, your baud rates chosen 
wisely, your parities the same on both ends of the 
link, and your bits flow freely -) 
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WE SUPPORT SINCLAIR 
QBOX USA 


COMPUTER BULLETIN BOARD SERVICE 
(810)254-9878 


We support all SINCLAIR COMPUTERS 
(QL, SPECTRUM, ZX8I1, Z88, Thor, QXL) 


Q Now in our 4th year on-line round the clock since October, 1993 


(J Full message area and File Download areas 


CL) We carry all popular SINCLAIR message areas from Europe 
CL) Calls from 14.4k--300 baud are welcome 


L) QBOX - USA runs on a SINCLAIR QL with Super Gold Card, 
Hermes, QUBIDE, 200MB drive, USR sportster 14.4 modem 
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The Nine Trials of TF Services 


Tony Firshman 


Hardware manufacture is a difficult business without the aid of 


God(s). 


MPLANE sprang from the 
Qbranch stable and Keith Mit- 
chell, who found a neat surplus 
notebook style case. A back- 
plane was needed, but Qplane 
was too high. 

| developed a low profile 2 x 
2 backplane which was 
launched at the recent Byfleet 
workshop. 

| produced a card board pro- 
totype, with motherboard (Au- 
rora or original QL) and expan- 
sion (Gold Card, Super Gold 
Card etc) at the side in the 
same plane. Qubide sits above 
the expansion, leaving one 
spare slot above the QL 
motherboard, and even a half 
Slot on Qubide. Now Keith 
found the cardboard prototype 
a little difficult to power up, but 
everything fitted - after minor 
(Imm) adjustments, even with 
the ROM slot fitted on the card. 


Ze so | committed the 
necessary £600 for board 
production. 

The 4 layer expensive 


boards arrived 4 days before 
Byfleet. | built up one and 
tested the internally generated 
RS232 voltages and they were 
fine - gave the designed 
+10v/-10v. 

Plugged in a QL motherboard 
- and DEAD. This is where the 
Gods start arriving. 


(Gods 1) At that very instant, 
Roy rang up! "Hang on a 
minute” - | said, while | saw 
£600 melting away. Again at 
that instant | realised | had the 
components on the wrong side 
of the board, reversing all sig- 
nals, including +5v/GND. This is 
unfortunately very easy to do, 
as PCB packages are not at all 
clear on this point - they call 
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sides ‘TOP’ and ‘BOTTOM’ My 
components, well most of 
them, needed to be on the 
bottom. While Roy was on the 
phone, | worked out that every- 
thing would be OK with com- 
ponents on the other side, but 
Keith had designed around the 
wrong cardboard version! 


(Gods 2) Keith used the 
reversed production board 
(Motherboard and SGC were 
reversed) and it fitted and 
worked 


(Gods 3) All the cables came 
out straight into the floppy/hard 
disk much more direct! 


(Gods 4) Aurora fitted in the 
shorter space with 2mm spare 

(Gods 4) A mounting hole on 
Aurora was in exactly the right 
place for a stud in the case 


(Gods 5) The first customer 
asked for the ROM slot to be 
fitted facing outwards. This 
wasnt exactly planned on 
MinisQL - only for mini-tower 
cases, but it worked. He then 
will have a removable RomDisa. 

(Gods 5) Rapid make an 
extended reset switch that is 
the right length to within 0.5mm 


(Gods 6) The cooling fan is 
now right beside the hot SGC 
board. 


(Gods 7) The side mounted 
expansion card is a few mm 
higher because of Goldfire (me- 
mory juts out below the board). 
With the enforced reversal of 
slots, this expansion now sits 
neatly OVER the QL mother- 
board, and the package is 
therefore narrower 


(Gods 8) One of the Super 
Gold Card heatsink screws sits 
exactly over a slotted hole on 
the QL motherboard. Removed 
and screwed back in through 
the motherboard, the SGC can 
be very firmly fixed to the 
motherboard and aligned - no 
more flying cards! 

(Gods 8) Now that the QL 
motherboard is reversed it 
doesnt foul the hard disk 
mounting frame 


(Gods 9) The width of the 
finished mplane setup is exact- 
ly the width of an AT mother- 
board - making design of Son 
of BraQuet (Mounting plate 
from Qbranch) a doddle. 

Roy was heard to comment 
‘When Tony has an idea, then 
reverse it! 

Now | still am not sure | be- 
lieve in God(s) despite singing 
in church choirs — practically 
every Sunday for over 40 
years, but........ 


Tony Firshman also writes: 
Another plus for the 


QL. 

| have a 3GB hard disk that 
failed under W98 - the fat got 
heavily corrupted. Even FDISK 
refused to work on it - boot 
sector problem. 

le it had some sort of boot 
sector that FDISK recognised 
sufficiently but then couldn't 
handle. It then quit to DOS 
without offering any rescue 
options. 

Ron Dunnett advised | format 
it under the qubide driver - that 
formatted a 128mb_ partition 
perfectly (and blindingly fast). 

| then put it back in the IBM 
beast, and FDISK correctly 
reported no boot sector and 
created a new one. Everything 
else worked and | now have a 
working hard disk. 

Well done Phil Borman (who 
wrote the Qubide ROM). 
| 
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| This ad does not give a list of all the features 
| of our excellent Editor QD98, it will mainly rh ri 4 
| list the new features which were introduced Sunsele 
| from the previous version QD Version 9 to 
| the current one. 
Here are its main features: "Hints" are given oe ndina 
on menu items and the toolbar. Quite useful, oreo 
because we have added many extra items 
and also added some additional features on "A opsed /=ip) 
| "DO"ing some existing icons. Of course, this cies ees cerp tas 
feature can be turned off. 
The toolbar can be turned off and on while 
QD is running. A number of QL users asked me to do this because they gain two extra lines - it is done now! 
Lines can be ordered, you can specify the start column in the text which is used as the sort criteria. 
x: The GOTO label/proc/fn are now better accessible. We have also 
§. introduced a GOTO User-defined list. This means, you define a string for 
which QD looks and all the lines containing this text are put into the 
GOTO list (in fact, only the bit of the line after the string). This is very 
useful to creote lists of all sorts, just use REMarks or other 
language-dependent combinations (C...) 
We have added scroll arrows next to every numerical value entry in all 
menus - you will find this very useful if you use the mouse quite a lot. 
PRINTing has been completely redone. You can print as before, or via 
| driver. You can program the driver yourself, because it can be a BASIC filter. 
BASIC and Assembler examples are on the disk. 7 
| Line highlights are now possible and VERY, VERY useful. You tell QD what kind 
| of highlights are required and it will highlight these lines in red paper. It can, 
| for example, highlight all assembler comments (; or *), all BASIC Functions and 
Procedures (which : is a kind of visual 
| “folding"), or any j# File” Command: lines with ">" in the 
| first three charac- | > = oe ters (useful for mes- Neseeads 
sage editing, |} a. = PBOX etc.) and, of 
course, user-de- {4 See Select uord my fined string. This will : 
highlight all lines pte ie ag containing the string you gave - quite a neat way of doing a search, | 
| if you think about in EY Buffer it. 
| "Context" menu We which can be popped up with the right mouse button has also been 
| introduced. This is |St=eeemee | : much easier to handle than previous cursor-dependent functions. 
These are the | major changes, plus various minor ones, of course. You will get a 
| new manual, not | petal) just additional pages. 


| The upgrade price is DM 39,90 for owners of QD9, and DM 49,90 for owners of older versions. 
| Please return master QD disk for upgrade. A new QD98 still costs only DM 125,- 


TERMS OF PAYMENT 


| Postage and package [Germany] DM 8,99 (if total value of goods is up to DM 50,- then only DM 5,99). [Europe] DM 14,50 (i 
total value of goods is up to DM 50,- then only DM 9,50). [Overseas] between DM 14,50 (1 item) and DM 35,- (maximum). Al 
| E  - ~ prices incl. 15% V.A.T. (can be deducted for orders from 7 i eee ent 


ISA 1 non~EEC~countries). E&OE. Cheques in DM, £'s, | 
e sone Eurocheques and Credit Cards accepted. 


__RUROGARD. / 


Gee Graphics! (On the QL?) - Part 8 


Building a Tetrahedron inside the QL 


Herb Schaaf 


Question: How do you de- 
scribe a tetrahedron? 

Answer: A polyhedron of four 
faces. 

lf (and only if?) you already 
know what a tetrahedron is, 
then you might be able to 
understand the descriptions 
and definitions given here. 
There seems to be an inverse 
relation between the comple- 
xity of the object and the dif- 
ficulty of defining the word. The 
more complex polyhedron is 
made up of faces (which can 
be polygons), and those poly- 
gons in turn consist of a sur- 
face enclosed by joined seg- 
ments of lines which exist 
between points. 


What are points, lines, faces 
(polygons), and polyhedrons? 
‘Point’ is one of those words 
that we all seem to understand, 
but find difficult to define. My 
old Webster's 5th Collegiate 
Dictionary gives the noun over 
a quarter-page of meanings, 
before going on to describe 
the verb. The word line’ in the 
same dictionary uses more 
space, and ‘face’ takes even 
more room. ‘Polygon’ is a very 
short entry, and ‘polyhedron’ 
shorter still 

Please be patient with me. 
When setting up arrays in the 
QL to describe a tetrahedron, 
[m going to use the term ver- 
tex {where 2 or more lines 
meet) instead of point, and use 
the term edge (where 2 or 
more faces meet) instead of 
line segment, and use the term 
face rather than polygon. This 
classic regular tetrahedron will 
have 4 vertices, 4 faces which 
are equilateral triangles, and 6 
edges of equal length. You 
might say that it looks like a 
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pyramid with a triangular base. | 
want to avoid the term side 
since it can be ambiguous; 
“side” can refer to an edge of a 
face or to a face of a polyhe- 
dron. 

Since we are visualizing our 
tetrahedron ‘inside’ the QL, it 
helps if we think of our monitor 
or TV box as the place where 
the QL displays It for us. | usual- 
ly think of the x-axis as the 
horizontal axis which increases 
in value as it goes from left to 
right. By the same token the 
y-axis is vertical and increases 
in value from bottom to top. | 
think of the z-axis as going into 
the monitor from near to far or 
in other words from the glow- 
ing screen and increasing in 
value as it disappears out the 
back of the monitor This ar- 
rangement is known as a left- 
handed system. 


Left-handed or Right-handed? 
To define the handedness of a 
system choose a hand and 
hold it so that: the index finger 
is extended parallel to your 
forearm, the middle finger is 
perpendicular to your palm, and 
the thumb is perpendicular to 
both the index and middle fin- 


gers. Think of the index finger 
as the x-axis, the middle finger 
as the y-axis, and the thumb as 
the z-axis, with your fingernails 
and thumbnail pointing in the 
positive direction. By one con- 
vention, angles are measured 
around an axis of rotation by 
aligning the extended thumb of 
that hand in the positive direc- 
tion of and parallel to the axis 
of rotation; your ring finger and 
little finger will naturally curl in 
the positive direction around 
that axis of rotation. There are 
other conventions, but I'll try to 
stick with this one for now. 
Locating points in three 
dimensional (3-D) space 
Imagine that x, y, and z were all 
equal to zero; this can be re- 
presented as a point described 
by the triplet (0, 0, 0). Imagine 
this point being located inside 
the middle of the monitor box 
so that it would be halfway 
from left to right, halfway from 
bottom to top {if you said 
halfway from top to bottom 
that would be a right-handed 
system), and halfway from 
front(near) to back(far). 

HSM Coxeter's book "Regular 
Polytopes’” has tables and 
values for many _ interesting 
geometric solids; we can use 
the following DATA set from 
page 52 of his book for the 4 
vertices (points) of a regular 
tetrahedron: 


Vertex# x y Zz Word description 
1 1 dy 1 right, top, far 
2 1 -1 -1 right, bottom, near 
3 -1 1 -1 left, top, near 
4 “1 -1 1 left, bottom, far 


The edges are between two points at a time, all combinations 
of 2 points from the set of 4 points: 


Edge# Beginning Vertex Ending Vertex 


AwnPRwWDN HE 
WON ee 
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The 4 faces contain all the 
combinations of 3 vertices at a 
time from the set of 4 vertices: 


Face# Vertex Numbers 
1 1, 2, 3 
2 1, 2, 4 
3 1, 3,4 
4 2, 3,4 


We could also have an array 
that contained the faces de- 
scribed as a collection of en- 
closing edges: 


Face# Edge Numbers 
1 72 


3’ 


a 
2 45.553 
3 obs 8 
4 4, 6, 5 


Suppose we now create a 
series of arrays in the QL to 
hold this data which describes 
the tetrahedron in 3-D. 

We could DIM tetrahedron_ver- 
tices(4,3) since the QL allows 
the array name to be as long 
as 127 characters; to keep it 
simple let's abbreviate and use 
DIM t_v(4,3) with the 4 referring 
to the 4 points. Since the QL's 
option base is zero in arrays 
we actualy have another 
zeroth "phantom point” which 
can come in handy. The 3 then 
refers to elements of the array 
that contain the x, y, and z co- 
ordinates respectively for each 
point, and again we have a 
“spare dimension’ in the zeroth 
place. 

We create a floating point array 
because we will be applying 
mathematical manipulations to 
these vertex values in order to 


perform rotation, — translation, 
and scaling transformations in 
3-D space. 


Now we can DIM t_e_v%(6,2) 
as an integer array for the 6 
edges, defining an edge as the 
segment between two points 
(vertices) from the array tv 
This is a list of the 2 vertices 
that go with each of the 6 
edges. We use the % to speci- 
fy these as integers and thus 
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use less of the QL’s memory. 
Extending this idea we can DIM 
t_f_v%(4,3) for the 4 faces, 
defining a face as the collection 
of 3 connected vertices. This is 
a list of the 3 vertices that go 
with each of the 4 faces. 

SO far so good, and trust me, it 
will get more complicated. 
Other possibly useful arrays will 
link: 

the edges that go with each 
vertex DIM t_v_e%(4,3}, 

the edges that go with each 
face DIM t_f_e%(4,3), 

the faces that go with each 
edge DIM t_e_f%(6,2), 

the faces that go with each 
vertex DIM t_v_f%(4,3). 


Another handy array to have is 
one to hold values for the 
“equation of the plane” and the 
normal’ for each of the faces. 
This will use floating point 
values, and might end up 
something like: 

DIM t_eqn(4,10) 


Translation, rotation, and 
scaling. 

These are the three simple 
transformations that are often 
combined with another three 
(shearing, reflection, and per- 
spective) by the use of matri- 
ces. | haven't gotten that far 
yet, but maybe before this 
series Is finished? 

Translation is similar to PAN 
(x-axis) and SCROLL (y-axis) 
and relocates the object in 
Space; you could think of it as 
Sliding or shifting the object 
parallel to one of the 3 axes. 
Rotation changes the orienta- 
tion of the object by revolving 
the object around a given axis. 
Scaling is a change in overall 
size that has an effect similar to 
zooming. 


SuperBASIC listing 


"Tetrahedron_bas" 
Try the listing ‘Tetrahedron_bas’ 
and see the effects of the 


three simple transformations. 
There is a menu so you can 
touch the key enclosed in [ ] 
to indicate your choice. When 
the prompt asks you to 
ENTER’ a value, put in the 
number and then touch the 
ENTER’ key. 

[RJotations are in degrees, and 
any value from -5/0000 to 
+570000 or so should be OK. 
Try values like 15, 30, 45, 90, 
and 180 where you know about 
what to expect. Confirm to 
your own Satisfaction that the 
convention described earlier 
for positive angles in a left- 
handed system is being fol- 
lowed. 

[S]cale factors larger than 1 will 
enlarge the object and factors 
smaller than 1 will reduce the 
object. A negative factor in- 
verts everything; try -1 to see 
the effect. A factor of zero re- 
duces everything to a single 
point, and that's all you will see 
of it after that! 

The “box” we are viewing is 
only a 4 by 4 space, so small 
values from -2 to +2 for the 
translations will do nicely. 
[T]ranslations along the z axis 
seem to have no effect, until 
you follow them with a [R]ota- 
tion about the x or y axis, 
when you will see that a 
change has been made. 

From the [OJriginal values try 
the following sequence: 
[T]ranslate x 2, [S]cale 55, 
[RJotate y 90, [RJotate x 45 
After you have oriented and 
ocated the tetrahedron, [Alni- 
mation of a crude sort will ge- 
nerate a sequence of images 
that could be stored as a series 
of “frames” for a movie. | hope 
to get to movie-making in a 
later article. Start with values 
around 12 degrees or so per 
frame and then experiment 
with larger and smaller values 
to see what difference it 
makes. 
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| hope you will have seen a_ In the next article | hope to 
tetrahedron in your very own — show more general procedures 


QL, 


and that you were able to —sthat-=swill_-let us build and 


manipulate and move it in 3. manipulate all 5 of the Platonic 
dimensions. Solids in the QL. 


100 
110 
120 


REMark Tetrahedron_bas 
REMark H L Schaaf December 9, 1998 
REMark to go with Gee Graphics #8 in QL Today 


130: 


140 


initialize : draw_solid t_f_v% : transforms_demo 


150 : 


160 
170 
180 
190 
200 
210 
220 
230 
240 
250 
260 
270 
280 
290 
300 
310 
320 
330 
340 
350 
360 
370 
380 
390 
400 
410 
420 
430 
440 
450 
460 
470 
480 
490 
500 
510 
520 
530 
540 
550 
560 
570 
580 
590 
600 
610 
620 
630 
640 
650 
660 
670 
680 
690 
700 
710 
720 
730 
740 
750 
760 
770 


DEFine PROCedure initialize 
set_screen : set_inks 
read_vertex_data : make_face_vertex_list 
find_face_centers : sort_face_zs 

END DEFine initialize 


DEFine PROCedure transforms_demo 
REPeat demo_loop 
transform menu 
IF ans$=="q" :EXIT demo_loop 
CLS : draw_solid t_f_v% 
PRINT #0; "“[space bar] for menu" : PAUSE 
END REPeat demo_loop 
INK 7 
END DEFine transformg_demo 


DEFine PROCedure set_screen 

graspix = 1/2 

IF VER$ == "JSU" THEN graspix = 344/549 

IF ((VER$ == "HBA") OR (VER$ == "JSL1")) THEN graspix = 476/645 
IF graspix == 1/2 THEN PRINT “What ROM are you using ?":PAUSE 
WINDOW 512, 200, 0, 0 : PAPER O : INK 7 : MODE 4 

WINDOW #0, 512, 56, 0, 200 : PAPER #0, 0 : INK #0, 4 : CLS #0 
horg_to_vert = 512/200 : REMark the window size in pixels 
vert_scale = 4 

horz_width = (vert_scale / (200-1)) * (512-1) * graspix 

SCALE vert_scale, -horz_width/2, ~vert_seale/2 

CLS 
END DEFine set_screen 


DEFine PROCedure read_vertex_data 
RESTORE 560 

DIM t_v(4, 3) 

FOR i = 1 TO DIMN(t_v) 

FOR j =1T0O 3 

READ t_v(i,j) 

END FOR j 

END FOR i 
END DEFine read_vertex_data 


REMark Original DATA set for tetrahedron from Coxeter 
DATA i, 1, L 
DATA 1, -1, ~-1 
DATA -1, 1, -1 
DATA -~1, -1, 1 


DEFine PROCedure transform_menu 

CLS #0 

PRINT #0;"[TJjranslation, [R]lotation, [S]caling, "; 
PRINT #0;"(Oljriginal data, [A]nimation or [Q]uit ?" 
ans$=INKEY$(~1) 

ang _num = CODE(ans$)MOD 32 

SELect ON ans_num 
1: motion$ = "Spin around “ :spin_around 
15 : initialize 
17: CLS #0 : RETurn 
: get_variables : rotate t_v, axis_num, amount 
20 : get_variables : translate t_v, axis_num, amount 
19 : goom t_v 
REMAINDER : GO TO 660 

END SELect 
END DEFine transform_menu 


tou ow wd Ww wou 
be 
oe] 
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PS: Any of our UNIX or 
X-window folks looked at ico 
and/or ico? ? 
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780 : 


790 
800 
810 
820 
830 
840 
850 
860 
870 
880 
890 
900 
910 
920 
930 
940 
950 
960 
970 
980 
990 
1000 


DEFine PROCedure get_variables 

IF ans_num = 18 : motion$="Rotation about " 

IF ans_num = 18 : measure$=" degrees " 

IF ans_num = 20 : motion$="Translation along " 

IF ans_num = 20 : measure$="" amount " 

get_axis 

INPUT #0;"ENTER "&measure$&" of "&motion$zans$&" axis", amount 
END DEFine get_variables 


DEFine PROCedure get_axis 

PRINT #0; motion$; "which axis; [x], [y], or [2] 2" 

ans$ = INKEY$(-1) 

axis_num = (CODE(ans$) MOD 32 ) - 23 

IF (( axis_num<« 1 ) OR ( axis_num >» 3 )) : CLS #0 : GO TO 890 
END DEFine get_axis 


DEFine PROCedure translate(array, axis_num, shift_amount) 
FOR i = 1 TO DIMN(array) 
array(i,axis_num) = array(i,axis_num) + shift_amount 
END FOR i 
find_face_centers : sort_face_zs 
END DEFine translate 


1010 : 


1020 
1030 
1040 
1050 
1060 
1070 
1080 
1090 
1100 
1110 
1120 
1130 
1140 
1150 
1160 
1170 
1180 
1190 
1200 
1210 
1220 
1230 
1240 
1250 
1260 
1270 
1280 
1290 
1300 
1310 
1320 
1330 
1340 
1350 
1360 
13°70 
1380 
1390 
1400 
1410 


1420 : 


1430 
1440 
1450 
1460 
1470 
1480 
1490 
1500 
1510 
1520 
1530 


DEFine PROCedure rotate(array,axis_num, turn_amount) 
DIM temp(3) 

rot_r = - RAD(turn_amount) 

sumin = (axis_num MOD 3) + 1 

difin = (sumin MOD 3) +1 

cos_r = COS(rot_r) : sin_r = SIN(rot_r) 


FOR i =1TO DIMN(array) 

temp(axis_num) = array(i,axis_num) 
temp(sumin)=array(i,sumin)*cos_r + array(i,difin)*sin_r 
temp(difin)=array(i,difin)*cos_r - array(i,sumin)*sin_r 


FOR j =1 70 3 
array(i,j) = temp(j) 
END FOR j 
END FOR i 


find_face_centers : sort_face_zs 
END DEFine rotate 


DEFine PROCedure zoom(array) 
CLS#0 


INPUT#0; "Enter Scaling factor", zoom_fac 

FOR i-=i1 TO DIMN(array) 

FOR j = 1T0 3 
array(i,j)=array(i,j) * zoom_fac 

END FOR j 

END FOR i 


find_face_centers : sort_face_zs 
END DEFine zoom 


DEFine PROCedure make_face_vertex_list 
DIM t_f_v%(A, 3) 
REMark 4 faces, 3 vertices each 
RESTORE 1350 
REMark vertices ordered for counter-clockwise closure 
DATA 3,2,1, 1,2,4, 4,3,1, 4,3,2 

FOR i = 1 TO DIMN(t_f_v%) 

FOR j = 1 TO 3 

READ t_f_v%(i,j) 

END FOR j 

END FOR i 
END DEFine make_face_vertex_list 


DEFine PROCedure find_face_centers 

DIM t_f_¢(4,3) 
REMark to hold the x,y,z values for face centers 
REMark and to determine order for drawing each face 
REMark for each face 

FOR i= 1TO4 

DIM sumxyz(3) 
REMark and for each vertex in that face 

FOR j = 1 TO 3 
REMark and for each of the coordinates 
FOR k = 1 TO 3 


QL foday 


1540 
1550 
1560 
1570 
1580 
1590 
1600 
1610 
1620 
1630 
1640 
1650 
1660 
1670 
1680 
1690 
1700 
1710 
1720 
1730 
1740 
1750 
1760 
1770 
1780 
1790 
1800 
1810 
1820 
1830 
1840 
1850 
1860 
1870 
1880 
1890 
1900 
1910 


1920 : 


1930 
1940 
1950 
1960 
1970 
1980 
1990 
2000 
2010 
2020 
2030 


REMark add them together 
sumxyz(k) = sumxy2(k) + t_v(t_f_v%(i,j 
END FOR k 
END FOR 3 


),k) 


REMark then take the average of the three values 


FOR k = 1 TO 3 
t_f_e(i,k)=sumxyz(k) /3 
END FOR k 
END FOR i 
END DEFine find _face_centers 


DEFine PROCedure set_inks 
DIM nks(A) 
REMark use 4 colors, one per face 
RESTORE 1690 
DATA 2, 4, 7; 242 
REMark red, green, white, gold 
FOR i=1T04 
READ nks(i) 
END FOR i 
END DEFine set_inks 


DEFine PROCedure sort_face_zs 
REMark arrange faces by z-value of face-ce 


nters 


REMark put t_f_ec(i,3)'s in order, showing most positive first 
REMark create index array of pointers for sorting z values 


DIM zsort(4) : FORi=1T04: gsort(i) 
REPeat short_sort 
swaps = 0 
FOR i = 2 T0 4 
IF t_f_e(zsort(i-1) ,3)<t_f_e(zsort(i),3) 
Swaps = swaps + 1 
swap zsort(i-1) , zsort(i) 
END IF 
END FOR i 
IF NOT(swaps) : EXIT short_sort 
END REPeat short_sort 
END DEFine sort_face_zs 


DEFine PROCedure draw_solid(f_v_array) 


os ee 


THEN 


END FOR i 


REMark at least one face (the most distant) will always be hidden 


FOR i = 2 TO DIMN(f_v_array) 
ii = gsort(i) : INK nks(ii) : FILL 1 


POINT t_v(f_v_array(ii,3),1) ,t_v(f_v_array(ii,3),2) 


FOR j = 1 T0 3 


LINE TO t_v(f_v_array(ii,j),1) ,t_v(f_v_array(ii,j),2) 


END FOR j 
FILL 0 
END FOR i 
END DEFine draw_solid 


2040 : 


2050 
2060 
2070 
2080 
2090 
2100 
2110 
2120 
2130 
2140 
2150 
2160 
2170 
2180 
2190 
2200 


DEFine PROCedure swap (ni, n2) 
ni =ni+n2:n2=ni-n2: ni = ni - n2 
END DEFine swap 


DEFine PROCedure spin_around 
CLS#0 
get_axis 


INPUT#0; "ENTER Degrees per frame of animation ?",frame_shift 


CLS #0 
PRINT #0; frame_shift; CHR$(186); 
PRINT #0;" per frame around the ";ans$;" 
PRINT#O;"{ESC] to stop" 
REPeat spin_loop 

rotate t_v,axis_num, frame_shift 

CLS 

draw_solid t_f_v% 


axis", 


2210 REMark change the INKEY$ value for display time per frame 


2220 
2230 
2240 


IF INKEY$(8) == CHR$(27) : EXIT spin_loop 
END REPeat spin_loop 
END DEFine spin_around 
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q-CceELT SOLTWIARE 


SOFTWARE FO 


| Dilwyn Jones Bargain Bundle : : Ee 

A bargain pack of his old DJC software, mostly recently updated versions - his 
| non-pointer driven commercial programs. Includes Basic Reporter (programming § aid), 
| Vision Mixer (fancy screens display utility), Quick Posters (text poster maker), 
Wordscheck, Convert-PCX (PCX graphics conversion utility), Simple Mailmerge (for 
| Archive and EasyBase), The Cat (multi column directory lister), Image Processor (graphics 
| program for QL), Screen Snatcher (screen picture capture system), Super Disk Labeller 
| and Super Disk Indexer. 


| DEV Manager.......... £14.95 

| Utility fo help to run awkward (and even not so awkward) software from sub-directories 
| or hard disk, especially suitable for use with systems including the DEV facility and with 
| Qubide’s SUB facility. Pointer driven. 


| Deskjet-A5...........11.95 
Print half-size pages side by side on HP Deskjet printers, useful for making booklets etc. 
Pointer driven. 


| Mini Graphics Printer.....£14.95 | 
| Catalogue your QL screens clipart collection with this utility which prints thumbnails by 
the pageful! Pointer driven. 


EasyBase.........£14.95 [Bisset * sen" 

If you have been looking for a really ase to use database program with no bells and 
whistles, just really easy to use for storing names and addresses, lists etc this is the one 
for you. Import from/export to Archive if required. 


| All programs available on disk only - please specify DD or HD disk required | 
| (will be supplied on HD disks unless specified). , 
| Payment by cheque or Eurocheque (Sterling) payable to D.Branagh, or | 
| further details from: 


Darren Branagh, Q-Celt Software, The Falconry, Glenmacnass, 
Glendalough, Co. Wicklow, Republic of Ireland. 
Tel:(+353) 4404-45319 = Fax: (+353) 404-45558 
Email: Q_CELT @hotmail.com 
OR darrenbranagh@hotmail.com 


| Q-Celt can supply 2nd-User QL-Hardware such as Trump Cards, Falkenberg | 
3 Keyboard I/F’s, unexpanded original QL’s etc. Just write or call! 
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New ED Drives 


Mark Knight 


At the recent Portishead work- 
shop | obtained a pair of ED 
floppy drives from WN Richard- 
son with a view to reducing the 
number of floppy disks needed 
to back up my hard disks. This 
article is to summarise my ex- 
periences of these drives from 
fitting to daily use in the short 
time since | obtained them. | 
also intend to repeat some in- 
formation that may be helpful to 
anyone thinking of buying HD 
or ED drives for use with a QL. 
First | should describe the sys- 
tem into which these drives 
were fitted: | have a PC mini- 
tower case, A Schon PC style 
keyboard interface and key- 
board, Q-Plane, a Gold Card 
and QUBIDE with two Conner 
hard disks, one of eighty-five 
megabytes and the other one 
hundred and eighteen mega- 
bytes. The old floppy drives 
are twin Sony HD drives, very 
quiet in operation and in the 
eighteen months or so since | 
bought them completely trou- 
ble free. The Sony drives have 
the usual beige front panels to 
match the minitower, but by the 
time | reached Bill he only had 
ED drives with black front pa- 
nels. Although | would have 
prefered the drives to match 
my case the colour is a minor 
niggle, and of course for many 
QL users black would be the 
better choice. 

The new drives are from Mitsu- 
bishi with the same model num- 
ber but with slightly different 
revision numbers and jumper 
settings. One has two choices 
of jumper settings for the drive 
select, DSO and DSi, equivalent 
to flpt_ and flp2_ on a QL; the 
other has an additional setting 
of DS2, equal to flp3_ on a QL. 
The drives are slightly heavier 
than the Sony mechanisms and 
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visibly better shielded, with me- 
tal covers on areas of the drive 
exposed on the Sonys. As | re- 
gard the Sony drives as very 
good the greater weight and 
visibly better construction of 
the Mitsubishis was a surprise. 
Both were set to DSi! in the 
factory, so after changing one 
to DSO! set about opening up 
the minitower. 

Fitting was simply a matter of 
removing the old drives, fitting 
the new ones in their places 
and then plugging the power 
leads and ribbon data cables 
into. the equivalent sockets. 
Switching on and attempting to 
boot gave no joy, the drive 
lights came on and stayed on 
and the QL booted from the 
hard disk even though flpt_ 
contained a disk with a BOOT 
program on it. Attempts to 
obtain a directory using DIR all 
gave ‘Not found’ errors and 
both drive lights glowed conti- 
nuously. 

This is usual with drives if the 
data cable is fitted the wrong 
way round, so | powered down 
and reversed the ribbon cable; 
booting from the new drives 
then proceeded smoothly. It is 
typical of so-called standardisa- 
tion in the computer industry 
that drives from two manufac- 
turers needed the data cable 
fitted with opposite alignment. 
Once working the new drives 
surprised me by being even 
quieter than the Sony drives; 
with disk drives a low noise le- 
vel is one sign of good quality. 
some familiar with drive history 
on the QL may remember that 
Mitsubishi drives have given 
trouble in the past with QL disk 
controllers, notably the compa- 
ny’s early DD drives and also 
one batch of their ED drives, 
which had a bug in the built-in 
drive firmware. lo counter the 
bug both the Gold Card and 
the Super Gold Card ROMs 
contain special code to work 


round it, activated by the 
quaintly named FLP_JIGGLE 
commana. Setting: 
FLP_JIGGLE 0 

switches off the special code 
and makes drive access 
quicker, while: 

FLP_JIGGLE 1 

makes the errant drives work 
properly at a small cost in ac- 
cess speed. As the bug was 
only present in one (admittedly 
large) batch of drives from 
Mitsubishi | kept to the 
FLP_JIGGLE 0 setting, assum- 
ing that Mitsubishi would have 
fixed the bug; this proved to be 
the case. Read your Gold Card 
or Super Gold Card manual for 
more information about 
FLP_JIGGLE, though you pro- 
bably won't need it. Do not use 
FLP_JIGGLE 1 with DD or HD 
drives or with ED drives not 
made by Mitsubishi; it will make 
perfectly sound disk drives un- 
reliable. 

The first day or so of testing 
was fairly intensive as | had a 
lot of disk copying to do, not 
specifically for this article but 
because | was preparing new 
versions of several software 
products to send to beta tes- 
ters. | had no ED disks but used 
a lot of DD and HD disks. | had 
no trouble reading, writing or 
formatting DD or HD disks. 
Often users of ED and HD 
drives have mistaken problems 
with the floppy disk drivers for 
oroblems with hardware. The 
problems usually result from 
either not using FLP_JIGGLE 
with the bugged ED drives or 
from trying to format and use 
HD disks without taking some 
precautions. These problems 
arise because of persistent 
bugs in the floppy drivers for 
the Gold Card family of pro- 
ducts as well as in SMSQ and 
SMSQ/E. This should perhaps 
be expected; remember the 
old drivers only had to deal 
with DD disks, single sided or 
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double sided, and no subdirec- 
tories; the new drivers must 
deal with HD, ED and DD disks 
as well as subdirectories and 
automatic detection of the disk 
density and drive parameters, 
which vary much more than 
they used to. 

The new drivers dont just de- 
tect when the disk in the drive 
has been changed, they must 
also detect the density of the 
disk. When you use the DIR or 
WDIR command, the driver will 
first assume the disk has not 
changed; if it has it will try the 
same density, then ED if the 
disk wasn't ED, if it can’t read it 
that way it tries HD and if that 
fails it will finally try a DD read, 
first double sided then single 
sided: only if all these fail will 
you get a “not found’ or "bad or 
changed medium’ error As well 
as all this there are different 
step rates for stepping bet- 
ween tracks on a disk and 
Startup times of drives also 
vary from one manufacturer to 
another 

Given all this it is amazing that 
the automated process ever 
works, but most of the time it 
works fine. On some hardware 
setups there can be great pro- 
blems formatting HD disks 
properly, though there is a fix 
for this. If you just put in a DD 
disk and type the standard: 
format flpi_ 

command, what happens? 
Well first the driver tries to for- 
mat the first track of the disk, 
track zero, as an ED track, if 
this fails it tries that track as an 
HD track and only when that 
has also failed will it try the DD 
format. Once this succeeds it 
will assume the rest of the disk 
is DD as well (seems reasona- 
ble) and continue with the 
format on that basis. 

Obviously typing the same for- 
mat command with an HD disk 
in the drive will try an ED for- 
mat first, then try HD and when 
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that succeeds it should format 
the rest of the disk as HD and 
give no trouble. Formatting an 
ED disk should actually be 
quicker than the others since 
there is no other format to at- 
tempt first. 

All this is fine in theory, and no 
doubt it works perfectly on the 
hardware Tony Tebby used 
when he developed the disk 
device drivers, but on some 
hardware setups it doesn’t. The 
result is that HD disks are often 
not formatted correctly, though 
nobody seems to know why. 
The way round it is simply to 
use some rarely documented 
extra facilities of the FORMAT 
command on the Gold Card 
and Super Gold Card (| am 
assured these are present in 
SMSQ and SMSQ/E). Note that 
the facilities | am about to 
describe may not be present 
on all systems, so try them and 
see. If you have an early Gold 
Card ROM you may need to 
upgrade (though quite how | am 
not sure, contact Miracle Sys- 
tems for details). 

The device driver will recog- 
nise extra parameters passed 
to it to overrule the automatic 
density detection, separated by 
the "*" (asterisk) character like 
this: 

format "flpi_*D" 

..which makes the device driver 
try a DD format only and give 
up immediately if it fails. (Note 
that the quotes are needed in 
this instance as otherwise the 
“*" character is interpreted as 
part of a multiplication expres- 
sion and as a name to format 
the expression becomes inva- 
lid). To sepcify HD use: 

format "f1lpi_*H" 

and logically enough for ED 
uSe: 

format "flp1_*E" 

It is very unlikely you will ever 
need it but the additional para- 
meter available is the single 
sided double density format, 


given by: 

format "flp1_*Ss" 

If you wish to give the disk a 
volume name, as usual up to 
ten characters, it is simply in- 
serted before the asterisk, like 
this: 

format "flpi_Fractals*H" 
and you don't need to pad out 
the name so that the "*" is the 
eleventh character of the name, 
as incorrectly stated in many 
Gold Card/Super Gold Card 
manuals. | am told the SMSQ 
and SMSQ/E format command 
works in exactly the same way, 
though only the QL version 
supports ED disks. If you have 
trouble with HD disks then 
always format them this way 
and the trouble usually vani- 
shes instantly. Turning off the 
automatic density detection in 
this way prevents most of the 
trouble with HD and ED disks. It 
also speeds up matters if a 
disk is faulty and can't be for- 
matted as it prevents the 
system trying alternative for- 
mats in a determined attempt 
to do as requested and format 
the disk. 

Anyway, knowing this may be 
one of the reasons | have 
never had trouble with HD 
disks using my old HD drives, 
and why | had no trouble using 
HD disks with the new ED 
drives. 

After a few days ! obtained 
some second-hand ED disks 
and to my surprise | couldn't 
get any of them to format to 
the full 6400/6400 sectors. | 
tried each disk several times 
but no joy; on a hunch | tried 
flp2_. All the disks formatted 
perfectly first time in flp2_ to 
6400/6400 sectors. flpi. was 
able to read and write these 
same disks but reformatting 
them always gave less than 
the full 6400 sectors. 

Advice from Tony. Firshman 
was that this was due to flpi_ 
being a dud. As Tony has been 
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building and testing all the 
boxed and powered drives for 
Bill he was able to assure me 
that this was the only one so 
far to be faulty just my luck to 
get the dodgy one. 
The next test was obvious for 
me, as | recently backed up my 
nard disk to a set of HD disks: 
using The Knight Safe with 
compression switched on this 
required seven HD disks, six of 
which finished up completely 
full with very little space on the 
last. When | used ED disks it 
required four the last of which 
was hardly used. The whole 
operation proceeded very 
smoothly and | was impressed 
by the extra speed of writing 
to the ED disks. 

A timed test was done, loading 
a small animation program with 
a large animation file from both 
HD and ED disks. This con- 
firmed the theory, taking 
(roughly in each case) thirty-six 
seconds to load from DD disk, 


eighteen seconds to load from 
HD and nine seconds from ED. 
Precise timings aren't important 
so |! didnt do further timed 
tests, but the improved feel of 
loading and saving on ED disks 
is significant. | did find the extra 
speed very noticable when 
loading large files from ED disk 
and this was easy to get used 
to. It seemed to take an age 
waiting for the same files to 
load from the slow DD disks 
afterwards. 

The extra capacity of ED disks 
is useful and | found | was able 
to pack a lot of working soft 
ware onto a disk when experi- 
menting. A copy of Turbo with 
source code to several pro- 
grams, along with compiled 
versions, notes and manuals in 
the form of text files could be 
packed into the subdirectory 
Structure on one disk and still 
leave plenty of space for 
expansion. | won't be using ED 
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floppy disks this way myself 
because my twin hard disks 
are even bigger and very much 
faster but | tried it out for the 
Sake of readers of this article. 
With over 2.2 times the capa 
city of HD disks ED disks are 
handy for my hard disk back- 
ups and that is really why | was 
interested. 

Previously the prices of ED 
drives put me off, but as good 
quality HD drives currently cost 
around £20 and this batch of 
ED drives are just £30 | think 
they are worthwhile. Even if the 
supply of ED disks dries up 
completely in the next few 
months as rumours suggest, 
once | have enough for my 
own purposes | can use the 
drives with HD and DD disks 
for normal use. If you have 
been thinking of obtaining ED 
drives for a while now is 
definitely the time to do so. 

= 


Assembly Language 
Programming - Part 3 


Norman Dunbar 


An Apology 

| have to apologise to all of you who were 
(eagerly?) awaiting part 3 of the series in the last 
issue Of QL Today. Due to circumstances beyond 
my control - ie my work - | was repeatedly sent 
away and had absolutely no chance to put the 
article together To compound matters further, | 
was then away on two weeks holiday in Mexico. 
(We left to come home on Monday and Hurricane 
Mitch arrived on Wednesday). 

At the point where | knew | was not going to 
have the article ready, | sent an email to Dilwyn at 
his work - unfortunately he had major problems 
with his work's email system and never got It! 
Luckily, he did get a later one sent to his home 
email account. 

So, my apologies to all concerned, let's hope it 
doesn't happen again. | am actually writing this 
part of the article while in a hotel in Cheltenham, 
yes, | have been sent away again so this article 
is being written on a laptop. 
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In part 2, page 31 of QL Today there is an incor- 
rect instruction. At the top of the page, there is an 
example of the CMPI instruction. The line should 
read : 

CMPI.size #data, destination 
CMP.size #data, destination 

On page 35, | discuss the Decrement and 
branch UNLESS condition’ instructions that will be 
appearing in the following article (this one). This 
should of course read ‘Decrement and branch 
UNTIL condition’ 

These errors were mine and no blame should 
be attached to anyone else! 


and not 


More Branches 

At the end of part 2, | left you with a promise 
that the DBcc instructions would be explained in 
this part, but just before we do that, there is the 
BSR instruction. This means ‘Branch to Sub-Rou- 
tine’ and acts very much like GOSUB in Super- 
Basic (an instruction | have never used in Super- 
Basic, but use almost in every program in 
assembler - strange that.) 


BSR comes in 2 sizes - byte and word. The 
format is: 


QL foday 


phical Software 


ProWess is a new user environment for the Q 
ProWesS is short for "PROGS Window Manage 
but it is much more than that. Apart from a ne’ 
window manager, it contains all the system: 
extensions from PROGS, and is essential if you; 
want fo run programs which need these! 
extensions. 

The ProWesS reader is a major part of th 
package. it is a hypertext document browser. This. 
means that text files which include formatting! 


to other files can be displayed and read in thi 
program. This is used in ProWesS to read (an 
possibly print) the manuals, and display the help, 
the ProWesS reader are in HTML format, the! 


World Wide Web pages. 


Pro Wess 


possibility ta allow programs to automatically | 


install themselves on your system, and to be able| : 


to run them without resetting the system. This | 
means that, when you get a new program, all you: 


have to do is insert the disk and indicate ‘start the _ 


program in flp1_", a menu option in the "utilities" | 
button. To install a program, you indicate “install| 
software’, and the software can be added to your 
system. This way, you don't need to know how to: 
write a boot file to use the multi-tasking. 


commands (including pictures) and possibly links | : 


files. The hypertext documents which are used by! - 


format which is popular on Internet to display. i 


Another important aspect of ProWesS is the! — 


ONew g VO. Wor S afiptication 
a frowerfil and. UCKY USER 
prrendly pele manages 


aon einen rangcenaaninseesiet akinesia 


ak do bsip DP gerequit Zz 
wake dohelp#ProWesS file manager quit Zzz 


*Rilelnfs link include aubtres. 


Ynone (game seca dick) ___ Gommande| 
oshyef Mot 
wie apo files 4° Tres All 


menutil_ h 
i delete c order c_ 
lenslish_¢ rename ¢ — 
‘menutils  Hleinfo_¢ 


action 


capabilities of your computer. 
ProWesS includes many programming libraries. | 
These include syslib, an interface to the operating 
system, PROforma, a vector graphics system, 
allowing rendering both on screen and on paper 
(via a printer driver). The DATAdesign engine is: 
also part of ProWesS, it is a relational database. 
system with a bonus, as you don't even need a’ 
key field. You get a powerful record at a time data 
manipulation extension to the language you 
already use. Of course it also includes ProWesS 
itself, the new resolution independent window! 
manager. 


vafeaad Easy to use program to create listings on any) 
printer (especially inkjet and laser). This ProWesS 
. ne} application allows you to indicate the files which 


have to be printed. Each calumn contains a footer | 
which can include the filename and filedate. The | 
listings always allow perforation. PFlist can create | 
your listings in two columns and in landscape (or | 
both). 


File search utility with many useful options, like 
the choice to search only files with a certain / 


Cd extension, and whether or not the directory tree. 
Roa has to be scanned. All occurences of the! 
eS searchstring will be displayed with line number or 
Q offset. You can also use special matching 
WF features, like case dependent, matching a space 


with a stretch of whitespace, and searching for a | 
word dilimited string. 


manage your font collection. You can preview, 
ONT-— fonts on screen, see what characters exist in a 
font and convert Adobe Type 1 and similar fonts | 


uti Is for use in ProWess. 


/ same size and position). 
| LINEdesign is good at handling text. You can easily put titles 


!at any size, rotation, etc. All the fonts which are available to 


LINEdesign 


Create artistic drawings, technical drawings, process bitmaps 
(even scale and rotate them!), and any kind of vector 
drawings. You can use grpahics objects to create the most 
fabulous drawings ever seen, Because LINEdesign is a vector 
drawing program, any part of the picture can be moved, 
scaled, rotated, slanted without any loss of precision or 
resolution. In LINEdesign, pictures are device independant, 
meaning that the printout will be the same on any printer (e.g. 


and full paragraphs on the page. All the fonts can be displayed 


ProWesS can be used in LINEdesign. 

LINEdesign is a drawing program, but it can also be used by 
people who are not good at drawing. LINEdesign is a great 
program for making leaflets, posters, and any kind of printed 
work. Lots of clipart and extra fonts are available from public 
domain libraries and BBS's. You can even import Adobe 
Illustrator files. 


DATAdesign 


Never before has it been so easy to create, fill in and maintain 
your personal databases. To start a new file, just type the 
names of the fields. To add or delete a field, no problem, just 
'do it. To change the name of a field, just indicate it. You can 
' choose which fields are displayed and also which records. You 
can have a hidden comment for each record, look at the file in 
tabulated form and transfer data to the scrap or hotkey buffer. 
Files can be memory based (for speed) or disk based (for 
Safety). 


2650 Edegem 
Belgium 


new address !! 


Dr. Fr. Hemerijckxlaan 13 /1 


tel : +32 (0)3/ 457 84 88 
fax : +32 (0)3/ 458 62 07 
email : joachim@club innet.be 
Www : http: //www.club.innet.be/~year2827 


Bisse & Gra 


ProWesS - BEF 2400 


Payment terms : 


You have to run ProWesS to make LINEdesign, DATAdesiga, fsearch, fontuti!s 
and PFlist work (even though DATAdesign uses wman). 

AL. our software is normally supplied on high density (HD) disks. However 
they can be obtained on double density (DD) disks at an extra casts of BEF 
10C. To use ProWesS and any of our other packages, you need a system with at 
least 2MB of memory. You should have a harddisk although a a two disk system 
will also work. The use of SMSQ/E is strongly recommended for optimal use of 
ProWesS. 

Ifyou are VAT registered (specify registration number) or live outside the EEC, 
the amount to be paid is the total (including postage) divided by 1.21 (no need 
to pay too much). 

Payment can be done by EuroCheque in BER or by VISA, EuroCard or 
MasterCard. Credit card orders can be handled by phone. For credit card, 
please specify name of card owner, card number and expiry date. 
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DATAdesign - BEF 1200 
LINEdesign - BEF 1200 


PWrile - BEF 900 PFlist - BEF 600 
fontutils - BEF 1200 fsearch - BEF 600 


Postage : Costs of postage: and packaging have to be added. 
ou can choose the qua 


ity. Rate depends on no of programs. 


[ || priority mail | ordinary mail 

| Copies | Belgium Europe World |Belgium Europe, Ww orld | 
fone || 100 200 | 

two | 135 340 | 

| 30r4| 160 560 | oe 

| 5to8 | 185 870 , 1250 , 185 | 550 705 
[more || 295 1130 1610 jj 295 | 800 1030 


All prices are in BEF, including 21% VAT 
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BSR.S label or 
BSR label 

Label is the destination of the subroutine to be 
executed. BSR is a PC relative instruction in that 
the destination is relative to the program counter 
- although it does not really look it. 

The size of the instruction, byte or word, de- 
fines the size of the displacement from the PC of 
the following instruction to the address of label. 
This displacement is added to the PC and the 
next instruction executed is the one at that ad- 
dress (or PC + displacement). As the displace- 
ment is signed, the byte sized BSR can ‘gosub’ 
-128 to +127 bytes from the PC while the word 
sized BSR can ‘gosub’ -32,768 to +32,/67 bytes 
from the PC. 

At this point, a small example will maybe make 
things a bit clearer Consider this chunk of (use- 
less) code. It serves no useful purpose apart 
from showing the use of BSR (and a few of the 
other instructions we have already discussed). 

Read through the following code and at the 
end | shall explain what it is doing. The only 
instruction not yet explained is RTS which for 
now simply means ‘Return To Sender’ - similar to 
RETURN or END DEF (sort of) in SuperBasic. 


Start MOVEQ #0,D1 

Again BSR.S Addon 
CMPI.L #10,D1 
BNE.S Again 
MOVEQ #0,D0 
RTS 

Addon ADDQ.L #1,D1 
RTS 


The code starts by setting D1 to zero in all 32 
bits - it is a long sized move. The label ‘Start’ 
simply identifies the start of the code fragment 
and need not be called start - it could be called 
fred. It acts like a line number in SuperBasic. 

The second line of code calls a sub-routine 
called ‘addon’ which lives only a few bytes 
further on - for this reason the byte sized variant 
of BSR is used and this makes the program 
smaller and slightly quicker - as explained later 
Had the distance to the sub-routine been more 
than 127 bytes (or less than -128) then the 
assembler would have complained and the 
source would have had to have been amended 
to remove the ‘.s’ from the instruction. 

The second line also has a label - ‘Again’. 
Labels are used in assembler programs to mark 
significant places in the code. In SuperBasic 
every line must have a number - in assembler 
only those referenced in the code need have 
one, but there is no problem putting labels where 
it makes the code more readable. 
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Following on, there is a check to see if the 
value in DiL is 10 (decimal) followed by a branch 
if not equal zero (BNE.S) to the label ‘Again’. If the 
value in D1 is not 10 the Zero flag will not have 
been set and so the code will start executing 
from the label ‘Again’. If Di.L does equal 10 then 
the branch to Again will be ignored. 

The next line sets DOL to zero. This is because 
any code that runs on a QL either as a result of a 
CALL address or EXECing a file returns any error 
codes to QDOS in DOL and zero shows that no 
error has taken place. All this will be explained in 
a later article. 


The RTS instruction ends a subroutine and 
means return to where you came from (almost). If 
the above code - beginning at ‘Start’ was called 
from SuperBasic, the RTS would return us to 
SuperBasic. If it was called from some other part 
of the assembler program, it would return us to 
the next instruction in that program. 

The subroutine called from the second line be- 
gins at the label ‘Addon’. It is very simply and 
adds 1 to the value in DIL before the RTS returns 
to the place where it was called from. 

Put simply, the code above loops around add- 
ing 1 to DiL until such time as DLL equals 10. At 
this point the code returns to wherever it was 
called from. 

This is not quite true. The RTS instruction re- 
turns back to the instruction that follows the BSR 
one. So the above code returns to execute the 
CMPIL 10,D1 instruction after running the code 
in the Addon subroutine. 

Now that we have a few more instructions un- 
der our belts, there will be more bits of code ap- 
pearing in the rest of the series. This allows the 
reader to alleviate the boredom of these articles 
and allows me to illustrate some examples of 
what | am trying to say! 


For DO = 10 to -1 step -1 ... 

Looks a bit like SuperBasic that, but you can 
do the very same in assembler as well. The 
above code illustrating the BSR instruction can 
be rewritten to use the DBcc or ‘Decrement and 
Branch’ instructions. These are very similar to the 
Bcc instructions from part 2 of the series but 
they have an additional purpose. They allow a 
loop to be executed a set number of times and 
also can cause an exit from the loop if a certain 
condition occurs while executing the loop. 


It might be better if these instructions were 
called DBUcc as in ‘Decrement and Branch UNTIL 
condition’ because that is actually what they do. 
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The full set of DBcc instructions is: 

DBCC - Carry clear 

DBCS - Carry set. 

DBEQ - Zero flag set. 

DBF (or DBRA) - Branch false or always. 

DBGE - Greater or equal. 

DBGT - Greater than. 

DBHI - Higher 

DBLE - Less or equal. 

DBLS - Lower or same. 

DBLT - Less than. 

DBMI - Minus. 

DBNE - Not equal (zero flag not set) 

DBPL - Plus. 

DBT - True. Very strange instruction, see below! 

DBVC - Overflow clear 

DBVS - Overflow set. 

The format of the instruction is : 

DBcc_ Dn\abel 

The counter is always a data register DO to D7, 
and only the lowest word is affected. The label is 
specified as a 16 bit displacement from the PC to 
the next instruction to be executed. The dis- 
placement is, as usual, signed allowing branches 
of between -32,767 and +32,768 bytes. 

This instruction does not affect the condition 
codes. They remain the same as they were be- 
fore the instruction. 

The operation of the instruction is in three 
parts: 

First, the condition is tested to determine if the 
termination condition of the loop has been detec- 
ted. This is the cc part. So a DBCS checks to 
see if carry is set. If the condition is detected, no 
branch will be performed and no decrement of 
the data register will be carried out either 

Second, if the condition is not detected, the 
lowest 16 bits of the data register is decremented 
by 1. If this results in a value of -1, then the loop is 
also terminated and no branch takes place. 

Third, the branch is taken to the label specified. 
(PC relative). 

Another example : 


Start MOVEQ #1000,D1 
MOVEQ #0,D2 

Loop ADDQ.L #1,D2 
CMPI.L #100,D2 
DBNE D1, Loop 

More More code here ... 


DiL is initialised with 1000 and D2 is set to 
zero. Then the start of the loop (at label Loop) 
where 1 is added to D2.L. Following the addition, 
D2 is checked to see if it equals 100. The DBNE 
instruction checks the zero flag and if not set - 
therefore D2 is not equal 100 subtracts 1 from Di 
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and if this does not result in Di becoming +1, 
branches to the label ‘Loop’ to go round again. 
At the label ‘More’ how can you tell which of 
the two cases ended the loop? As you know, the 
loop is ended when the condition is detected or 
the counter reaches -1. As the DBcc instructions 
do not change the flags you can make a simple 
check on the Zero flag or test Di to see if it is -1 
or not. So the code that goes in at label ‘More’ 
will be this: 
More BNE.S  Got_100 
Not_100 Process Di = -i here 


Got_100 Process D2 = 100 here 


Obviously, if we run a loop 1001 times where Dt 
goes from 1000 to -1, adding 1 to D2 then at 
some point D2 must equal 100 and that will be 
the only termination of the loop. D1 will never get 
to -1. 

There are two interesting’ DBcc instructions. 
These are ‘DBF’ (Decrement and Branch Until 
False) and ‘DBT’ (Decrement and Branch Until 
True). What is so interesting about these two? 

DBF is commonly written as DBRA which is 
more meaningful as it implies that a decrement 
will be done followed by a branch. This is exactly 
what happens. The condition FALSE can never 
be created so the instruction always branches 
until the counter becomes -1. 

DBT is the opposite. It never branches be- 
cause the condition is always detected. | have 
never seen a DBT instruction used in any pro- 
gram | have read, written or disassembled. 

Note that the loop is terminated when the 
counter becomes set to -1. This means that the 
above loop will have 1,001 iterations assuming 
that D2 never became 100. This can cause con- 
fusion to programmers used to processors that 
stop at zero. | learned on a Z80 (Sinclair 2X81) 
and there was a DJNZ instruction which subtrac- 
ted 1 from the B register and branched if it was 
non zero. 

To loop around 10 times you set B to 10 and 
just did it. On the 68000 series, you would set 
the counter to 9 not 10. Some programmers do 
this and others do it with the counter set to 10 
but skip the first iteration. The following two 
examples are doing the same thing: 


Example 1. 
Start MOVEQ #10,D0 
BRA.S Skip 
Loop BSR Useful_code 
Skip DBRA DO, Loop 
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Example 2. 

Start MOVEQ #9,D0 

Loop BSR Useful_code 
DBRA DO, Loop 


In example 1 the programmer sets the counter 
to the number of times the loop is to be exe- 
cuted but then skips over the loop code itself to 
the end of the loop. The counter is reduced to 9 
and the lop is entered properly this time. The 
Subroutine at label ‘Useful_code’ will be executed 
when the counter has values 9,8,7,6.5.4.3,2,1.0 or 
10 times. 

In example 2 the programmer sets the counter 
to 9 and then executes the code as normal. 
Once again the loop code at subroutine Use- 
ful.code will be executed 10 times once again, 
with the values 9,8,7,6,5,4,3,2,1 and 0 in the coun- 
ter register DO. 

Which is the best to use? It’s up to you. Some- 
times | use the first forms and sometimes the 
second. As far as reading source code is con- 
cerned, | prefer the second method because you 
can write something like: 

Start MOVEQ #10-1,D0 


Which at least shows better that the loop will 
be executed 10 times. Unfortunately, when you 
disassemble the above instruction the assembler 
has calculated that 10 - 1 is 9 and it has once 
again become : 

Start MOVEQ #9,D0 


The first method, where the loop counter is 
initialised with the actual iteration count, then 
skips the loop loses out in that there is the extra 
BRA.S instruction which uses up 2 bytes every 
time it is used, and the BRAS has to be execu- 
ted as well as the jump - all of this takes time. 


Counting 

In the above code fragments, | introduced the 
ADDQ instruction to add a value to a register 
There are a few arithmetic instructions covering 
addition, subtraction, division and multiplication. 


ADD.size source,Dn or 

ADD.size Dn,destination 

This adds the source to the destination. The 
destination is overwritten but source is not affec- 
ted. The size can be byte, word or long. All the 
flags are affected as follows: 

N is set if the result is negative, cleared if not. 

Z is set if the result is zero, cleared if not. 

V is Set if an overflow was generated, cleared if not. 
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C is set if a carry was generated, cleared if not. 

X is set to the same value as the C flag. 

Note that byte sized ADDs cannot be done if 
source is An. If destination is An then ADDA 
should be used, however some assemblers will 
convert ADD Dn,An into ADDA Dn.An for you. 


ADDA.size source,An 

This adds the source to the address register 
specified. The size can only be word or long but 
note that regardless of the size of source, the 
whole of the address register is affected. Words 
are sign extended to 32 bits. This instruction has 
no effect on the condition codes. 


ADDI.size #data,destination 

This instruction adds immediate data to the 
destination. The flags are all affected as per the 
ADD instruction above. The size can be byte, 
word or long. It is not permitted to use this to add 
to an address register 


ADDQ:size #data,destination 

This is a very quick version of the above ADD! 
but it can only be used to add values between 1 
and 8 to the destination. The size is byte, word or 
long as required. This instruction is always 2 bytes 
long where the ADDI can be 4 or 6 bytes. Use 
ADDQ wherever a value between 1 and 8 is to be 
added. 

The flags are affected as per the ADDI instruc- 
tion. The difference between this and ADDI is that 
you can use ADDQ to add 1,2,3.4.5,.6,7 or 8 to an 
address register Useful in loops. 


ADDX.size Dx ,Dy 

ADDX.size -(Ax),-(Ay) 

This one adds with the X flag added as well. It is 
useful when adding numbers together that are 
more than a register long - 32 bits. If you were to 
write a program that used 8 bytes in memory to 
store a number, then you could add two of them 
together using ADDX. 

The destination becomes set to the value 
source + destination + X flag. 

The flags are affected as follows : 

N is set if the result is negative, cleared if not. 

Z is UNCHANGED if the result is zero, cleared if not. 

V is set if an overflow was generated, cleared if not. 

C is set if a carry was generated, cleared if not. 

X is set to the same value as the C flag. 

Note the Z flag. If the result is zero it will be left 
as it is and not changed. If the result is non zero it 
is cleared. For this reason the Z flag should be set 
before any ADDXing takes place so that at the 
end, the result of zero shows up by having the Z 
flag still set. 
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This instruction and the SUBX one are mostly 
used in multiple precision addition and subtraction 
routines. 


ABCD Dx,Dy 

ABCD -(Ax),-(Ay) 

This is Add Binary Coded Decimal and is almost 
identical to ADDX above except that the values in 
the source and destination are treated as BCD 
instead of binary. Only 8 bits of the source and 
destination are affected. 

A quick example : 


Start MOVEQ #$19,D0 
MOVEQ #$03,D1 
ABCD DO, D1 


Assuming that the X flag is clear this will result 
in Di being set to $22 which is the result of 
adding 19 and 3 in DECIMAL. The hexadecimal 
numbers in the register $19 and $03 are inter- 
preted as decimal digits, one digit for each 4 bits. 
The above example Is actually adding 25 and 3 
to make 34 ! 

The flags are affected as follows : 

N is undefined. 

Z is UNCHANGED if the result is zero, cleared if not. 

V is UNDEFINED C is set if a DECIMAL carry 
was generated, cleared if not. 

X is set to the same value as the C flag. 


The Subtraction instructions are exactly the 
same as the Addition flags, but subtract instead. | 
have listed them below, but not explained them, 
read the corresponding ADD instruction for 
details. 

SUB, SUBA, SUBI, SUBQ, SUBX and SBCD. 


DIVS source,Dn 

This instruction divides destination by source 
and puts the result into destination. Source Is a 
word size and destination is long. The operation is 
carried out using signed values. The size is al 
ways word. 

The destination WORD Is divided by the source 
WORD and the result put into the destination LOW 
WORD. The remainder is placed in the destination 
HIGH WORD. 

Any attempt to divide by zero will cause a 
divide by zero exception to occur and on a stan- 
dard QL this will lock up. If overflow is detected 
during the operation the overflow flag is set but 
the operation is aborted and the source and desti- 
nation are unaffected. 

The flags are affected as follows : 

N is set if the quotient is negative, cleared 
otherwise. Undefined on overflow. 

Z is set if the quotient is zero, cleared if not. 
Undefined on overflow. 
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V is set if division overflow is detected. Cleared 
otherwise. 

C is always cleared. 

X is never affected. (Unchanged) 

For those of us with short memories or a long 
period since our schooldays, the quotient is the 
result of the division. The remainder is what is left 


over. 

Start MOVEQ #100,D0 
MOVEQ #9,D1 
DIVS  D1,D0 


Results in DO being set to $00010009 which is 
9 remainder 1. The 9 is in the lowest word while 
the lis in the highest word. 

The instruction should be read as ‘divide source 
into destination’. 


DIVU source,Dn 

This is identical to the above except that both 
Operands are treated as unsigned numbers. The 
flags are affected as per the DIVS instruction. 
Although the quotient is always positive, the N 
flag is set to the value in the highest bit of the 
lower word of destination. (ie the sign bit of a 16 
bit word) 


MULS source,Dn 

Multiply the destination word by the source 
word and place the LONG result into the destina- 
tion register Both operands are treated as signed 
numbers. 

The flags affected are : 

N - set if the result is negative, cleared otherwise. 

Z - set if the result is zero, cleared otherwise. 

V - Always cleared. 

C - Always cleared. 

X - Unchanged. 


MULU source,Dn 

Multiply the destination word by the source 
word and place the LONG result into the destina- 
tion register Both operands are treated as un- 
signed numbers. The flags are set or cleared as 
per the MULS instruction. The N flag is set to bit 
31 of the result. 


NEG. size destination 

This instruction converts the binary value in the 
destination to its two’s complement value. This is 
done by subtracting the current value from zero, 
putting the result back into the destination and 
setting the flags. All the flags are affected by this 
instruction. The instruction can act upon byte, 
word or long sized values. 

The flags affected are : 

N - set if the result is negative, cleared otherwise. 

Z - Set if the result is zero, cleared otherwise. 
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V - set if an overflow occurred, cleared otherwise. 
C - Cleared if the result was zero, set otherwise 
X - Set the same as the C flag. 


NEGX.size destination 

Same as NEG above except the value in the X 
flag is also subtracted to get the final result. The 
flags are not affected in the same way as NEG, 
but as follows : 

N - set if the result is negative, cleared otherwise. 

Z - set if the result is zero, UNCHANGED 
otherwise. 

V - set if an overflow occurred, cleared otherwise. 

C - Set if a ‘borrow’ was generated, cleared 
otherwise. 

X - Set the same as the C flag. 


NBCD destination 

This instruction works on byte sized values 
only. It is similar to NEGX above, but the values are 
treated as decimal and not binary. The contents of 
the byte at ‘destination’ is subtracted from zero 
then the current value of the X flag is subtracted 
as well. The result is put back into ‘destination’ 
and the flags set as follows : 
- undefined 
- set if the result is zero, cleared otherwise. 
- undefined 
- set if a borrow was required, cleared otherwise 
- Set the same as the C flag. 


KOON 


The Project 

At this point, we are at the end of part 3. How- 
ever now is a good time for a word or two about 
the project mentioned back in part 1 of this series. 

Now that we are starting to understand a few 
more instructions, we are seeing small snippets of 
code. This is fine for as long as we need it, but it 
does not allow you to become confident in writ- 
ing and understanding a fairly large program. | 
know, | had to learn as well even if it was a long 
time ago. 

The project is what we shall be developing as 
this series progresses. We are going to write a 
program that is very useful for assembly lan- 
guage programmers - a disassembler! 

The project will develop QLIdis and this will be a 
simple and hopefully easy to understand dis- 
assembler which will be developed of a number 
of issues and will be a very useful addition to your 
arsenal of assembler programming tools. 

What tools are actually required for assembly 
programming? | have written, in the past, a few 
articles for this magazine giving a brief overview 
of assemblers, editors, disassemblers and moni- 
tors. These are the tools that you will need. 

While it would be nice to be able to write an 
assembler, how would we manage to assemble it 
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? Hand coding in hex or binary is not easy and 
prone to errors. Of course, | could (?) write it and 
give you the hex code to feed into a hex loader 
but what would you learn? How to type hex num- 
bers into a program is all, | suspect. 

Ok, a disassembler is quite a big undertaking, 
how do we assemble it? If you remember back to 
part 1, | mentioned that | had hoped to use George 
Gwilt’s GWASS assembler for the series only to 
find that it will not run on a 68008. | lamented this 
fact and asked if anyone had a ‘free’ assembler 
that would run on the standard QI's 68008 proces- 
SOI. 

| then received an email from George Gwilt who 
offered his unpublished GWASSL_ assembler 
which will run on the 68008, so thanks to George, 
we Can all have the same assembler QL Today 
will be issuing the assembler on a future cover 
disc. If you cannot wait to get hold of a copy, it will 
soon be in the Quanta library. 

in this series, | have not specified which of the 
many addressing modes are valid for each 
instruction, not have | specified the ‘bit pattern’ of 
the actual instruction (its hex code) there is a 
reason for this. It takes a lot of typing, is very 
boring and prone to error George Gwilt, once 
again, comes to the rescue. Part of his GWDIS (a 
disassembler) package includes a file holding all 
the instructions, their op codes, the flags affected 
etc etc and George has also made this available 
to QL Today readers. Hopefully this file will also be 
on the cover disc. 

SO now we are armed with almost all we need 
to get the project underway except an editor 
Maybe Dilwyn will find room to put QED on the 
cover disc as well. (Over to you Dilwyn and 


See you in part 4. 
| 


QDOS Bugs - Part 3 


Mark Knight 


Last part of our series of known QL 


ROM Bugs 

69. If buffer full error occurs in INPUT then cursor 
may be left on in INPUT window and getting 
back to command line may be impossible in 
AH (SYSTEM). AH JM 
Fix: Be careful on these systems not to input 
text longer than 128 characters using input, 
especially on AH. 

70. CAPSLOCK affects various other characters 
besides the alphabetic characters though it 
should not do so (SYSTEM). AH JM JS MG 
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RWAP QL SOFTWARE 


All software only available on 3.5" disk 
Manuals all supplied in Quill format 
All programs need 256K min. unless specified 


WARGAMES 

War In the East MKII v1.24 (Upgrade from original only) £10 
D-DAY MKII v3.04 (The Allies Take on the Germans) £15 
Grey Wolf v1.7 (Graphical Submarine Adventure) £10 
ADVENTURES 

Return to Eden v3.08 (Graphics & Text Adventure - 3 disks) £15 
Nemesis MKI v2.01 (Text Adventure) £10 
The Prawn v2.01 (Spoof Text Adventure) (128K) £10 
Horrorday v3.1 (Humorous Text Adventure) (128K) £10 
West v2.00 (Real-time Text Adventure) (128K) £10 
The Lost Kingdom of Zkul v2.01 (Real-time Text Adventure) (128K) £10 
Adventure Package 1 (Nemesis MKII, The Prawn & Horrorday) ONLY £25 
Adventure Package 2 (Return to Eden & any other adventure) ONLY £20 
Adventure Package 3 (West & The Lost Kingdom of Zkul) ONLY £15 
GAMES 

Deathstrike V1.5 (Scramble Clone) MEW £5 
Arcade Package 2 (Hoverzone & Deathstrike) STEW £8 
Open Golf v5.19 (Golf Program - Good Graphics) (384K) £10 
Quizmaster IT Package (Original + Question Module 2) (128K) £7 
Stone Raider IT v2.00 (Boulderdash clone) (128K) £5 
Hoverzone v1.2 (defender clone) £5 
Arcade Package 1 (Hoverzone and Stone Raider II) ONLY £8 
UTILITIES / GENERAL INTEREST 

Sidewriter v1.08 (Print spreadsheets and text files sideways) £10 
QL Genealogist v3.21 (create a family tree) (2MB) £25 
Genealogy for Windows on PCs - ask for details £55 
Quick Mandelbrot [II v3.01 (Explore the Mandelbrot Set) £10 
3D Terrain v1.23 (Displays Abacus Files as Pictures) (196K) £10 
SToQL v1.29 (Converts ST screens to QL format) £10 
Q-Route v1.07 (PD Demo Version Route Finder Program inc map) (796K) £2 
Q-Route Britain Map (As at 24/8/98 - needs Q-Route!) INEW VIERSIGR! £2 


Q-Route West Yorkshire Map (As at 24/8/98) Ny £1 


Q-Route Catalonia Map (As at 10/10/98) 7 £2 
Flashback SE v2.03 (Upgrade from Original Only) (128K) £5 
(Upgrade from versions sold by RWAP Software) £3 


NOW RELEASED | 
The SBASIC / SuperBASIC Reference Manual (this is the book everyone is talking about - 1000+ pages of | 
essential information for the BASIC programmer, together with electronic index, example programs and 
public domain toolkits). The price of this book is £40 plus post and packing (£7 UK, £12 Eire, £22 | 
Europe, £32 Far East & Australasia, £25 Rest of World). Why not pre-order and collect at a show near you?? 


HOW TO ORDER 
CONTACT: Rich Mellor, 26 Ashenhurst Road, Russells Hall, Dudley, West Midlands DY1 2HH 
Tel: 01384-350043 


If your system can read HD or ED disks, please specify. 


(Payment must be cheque in Sterling payable to R. Mellor) 
(Credit Card Users can order via QBranch) 
Visit our Web Page: http://www.qbranch.demon.co.uk/rwap.html 
Send an S.A.E. and blank disk for our current catalogue 
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Fix: No easy fix but usually doesn't matter. 
Trying to send a nul file over the network 
crashes the transmitting QL (SYSTEM). AH 
JM JS MG 

Fix: if a channel is opened to the network 
and then it is decided that the transmission 
is a mistake send one byte before closing 
the channel. 

Attempts to FORMAT an mdv cartridge when 
either motor is still spinning {e.g. verifying the 
last file saved etc) then an ‘in use’ error 
occurs even if all channels to the drive are 
closed (SYSTEM). AH JM JS MG 

Fix: Very minor bug hardly likely to bother 
anyone now, but if you still use micordrives 
only attempt to format them when no mdv 
drive motors are active. 

SCROLL accepts parameters outside the do- 
cumented range and produces odd (some- 
times useful) results (SYSTEM). AH JM JS 
MG 

Fix: Same as bug 68 check your listings 
carefully and this bug doesn't matter Read 
any documentation for the bug carefully if 
you Intend to use the effects, but | suggest 
not doing so as future systems may not 
allow your program to run properly. 

Very high pitched notes produced with BEEP 
or equivalent system calls may make other 
activities of the second processor unreliable, 
eg. keyboard reading and serial ports 
(SYSTEM). AH JM JS MG 

Fix: Only good fixes are Hermes chip or 
Super Hermes to replace the code in the 
second processor which is responsible for 
the problems. 

KEYROW confuses some key combinations 
involving CTRL and ALT contrary to what the 
QL manual says (SYSTEM). AH JM JS MG 
Fix: No fix, problem is built into the design of 
the QL and the manual is wrong. 

lf a multitasking job starts up while Super- 
BASIC executes a BEEP or KEYROW the 
system may crash (SYSTEM). AH JM JS MG 
Fix: no known fix so be careful. 

Most QL systems allow priorities of multi- 
tasking jobs to be set outside the official 
documented range of 0 to 127, usually 0 to 
255 (SYSTEM). AH JM JS MG 

Fix: This bug is useful, as the range of priori- 
ties from 0 to 255 allows more differential 
between jobs and low priority jobs will take 
even less processing time from the highest 
priority ones. It is strongly suggested that 
programs for distribution never use priorities 
outside the official 0 - 127 range as on diffe- 
rent systems this will produce different 
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effects. As an example Minerva allows 
signed byte values (-128 to 127) to permit 
background tasks. The extra speed gain 
from using a priority of 255 is not worth 
giving other users compatibility problems, it is 
usually around 1 - 2% though it may be more 
on some systems. 


Minerva 1.97 problems. 


1. 


RECOL problem (SYSTEM). 

RECOL in MODE 4 doesn't recolour white 
pixels properly unless the seventh parameter 
is passed, which is the yellow parameter in 
MODE 8: 

RECOL 0,1,2,3,4,5,6,0 

won't recolour white pixels to black in 
MODE 4, while: 

RECOL 0,1,2,3,4,5,0,0 

will work. In MODE 8 RECOL works as it 
should. 

LIGHTNING SE problem (SYSTEM). 

When using Lightning SE on a Minerva 
system you must close windows in the oppo- 
site order to opening otherwise they will 
leave “ghost” windows which wil be visible 
and cleared, redrawn etc. each time MODE 's 
used, until a channel with the same Unumber 
is opened. 

Fix: This problem is fixed by loading the 
Pointer Environment or simply by not loading 
Lightning SE. There is not much point in 
using Lightning SE on a Minerva 1.97 
anyway as it provides little extra speed over 
the ROM screen driver or maths functions 
unless you intend to use the reduced preci- 
sion options. Loading just the maths func- 
tions is fine. 

In-Line IF problem 1 (BASIC). 

There are various problems with these, the 
most important of which is that when such a 
single-line structure is used PROCedure or 
GO SUB calls may be called more than once 
when they should not be. Although most 
programmers would suggest that GO SUB 
should never be used in SuperBASIC this 
also applies to PROCedure calls so it is a ge- 
nuine problem, though it doesn't apply to 
FuNction calls. 

lf your program contains: 

11200 IF Loaded=1 THEN PRINT FileName$: ELSE 
:PRINT "No file":END IF:Test_FILE 

then the PROCedure called Test_FILE will be 
called twice if the variable "Loaded does 
equal 1! 

The easy solution is dont do it, use this 
instead: 
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11200 IF Loaded=1 THEN PRINT FileName$:ELSE 
:PRINT "No file! 

11210 Test_FILE 

or better stil: 

11200 IF Loaded=1 THEN 

11210 PRINT FileName$ 

11220 ELSE 

11230 PRINT "No file" 

11240 END IF 

11250 Test_FILE 

.which is easier to change should the 
programmer wish to add to it later 

In-line IF problem 2 (BASIC). 

if you should use the even worse structure of 
having an in-line IF and the ELSE clause con- 
tains another IF (| can recommend a good cli- 
nical psychologist) then Minerva can become 
confused about which END IF belongs to 
which IF (and who can blame it). So: 

11200 IF Choice=1 THEN EXEC_W "Quill":ELSE IF 
Choice=3:EXEC_W "Abacus": END IF:NEXT Loop 
May not work properly (never mind the 
details!) 

Fix: One fix could be: 

11200 IF Choice=1 THEN EXEC_W "Quill":ELSE : IF 
Choice=3:EXEC_W "Abacus": END IF:NEXT Loop 
IN other words, add a colon after the ELSE! 
A better fix is don't use these ridiculous 
nested single line clauses and write code like 
this: 

11200 IF Choice=1 THEN 

11210 EXEC_W "Quill" 

11220 ELSE 

11230 IF Choice=2 THEN 

11240 EXEC_W "Abacus" 

11250 END IF 

11260 END IF 

11270 NEXT Loop 

or better still use SELect for this kind of 
thing! 

DLINE to the last line of a program could 
crash the computer (BASIC). 

Fix: Don't do it. This can be a pain if you 
forget, as the only way out is the reset 
button. 


ERR_xx Functions return 1 if a higher error 
has occured (BASIC). 

Fix: No easy fix, so don't rely on these func- 
tions, use other methods of finding errors. 
ERNUM followed by SELect? 

FILL bug: Minerva 1.97 has its own version 
of the official QL ROMs bug number 48, with 
small variations just to make life more 
interesting (SYSTEM). 

Fix: The same, draw objects starting from 
top or bottom rather than sides. 

RENUM oddities (BASIC). Various problems 
are present associated with RENUM, DATA 
and READ, along with certain small or very 
large line numbers. These may result in ab- 
surd negative line numbers appearing after 
RENUM is used, DAIA being RENUMbered 
and a complete system lockup, especially if 
you try and RUN or EDIT the program. NEW 
usually rescues the situation, CLEAR defi- 
nitely won't. 

Fix: Before reLOADing a program that exhi- 
bits this problem turn off integer tokenisa- 
tion by using POKE \\212,128 (and yes, do it 
before you LOAD). Note that QLOAD won't 
do in this situation, you have to LOAD a text 
listing type SuperBASIC file. Don't try and 
QSAVE a program once the problem crops 
up, it will probably save in such a corrupt 
form it will be worse than useless and will 
only crash your system if you QLOAD it 
afterwards. 

LINE bug: Sometimes when using the Super- 
BASIC LINE procedure or programs that call 
the equivalent system routines do not join up 
lines that have the same floating point coor- 
dinates for their ends. This is similar to the 
MG ROM bug (number 58) but occurs in 
different circumstances (SYSTEM). 

Fix: Same as the MG ROM fix, plot the end 
points over again using POINT or load 
Lightning graphics extensions. 


Letter-Box 
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Graham Bindon writes: 
This letter is on disk 
because | have no 
printer. it is about 
my attempt to buy 
one. 
My Star LC10 nine pin matrix 
printer has served me well for 
many years but it finally gave 
up the ghost and | thought to 
buy an ink jet printer (As well 
as a QL | possess an ancient 
Acorn Archimedes which, by 


courtesy of the Archimedes 
Fractal Group, produces the 
most stunning Mandelbrot ima- 
ges that would benefit from a 
high definition printer). 

An Epson Stylus 440 seemed 
to meet my requirements of 
price and facility, so | bought 
one. You can imagine my 
horror when the accompa- 
nying booklet (it could not pos- 
Sibly be called a manual) in- 
formed me that the minimum 
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system requirements were a 16 
megabyte PC with Windows of 
various kinds, a CD-ROM drive 
and a virtually infinite hard disk 
drive! 

No doubt | am an innocent in 
such matters but one could 
reasonably expect that most 
small printers could be used 
with most small computers, as 
is the case with monitors - (at 
least | hope it is?). 

The booklet told me how the 
printer was set up, how paper 
was changed, how to fit the 
ink cartridges, how to change 
them and what the buttons 
and lights were for There was 
also a short bit on how to print 
your first document using, of 
course, Windows. 

Assuming the booklet was a 
piece of commercial sheenani- 
gans aimed at selling more and 
bigger PCs it occured to me 
that the manual containing in- 
formation about printer codes 
and management must be 
missing. Then a CD unearthed 
itself from the packaging 
which | supposed contained 
the vital information but was 
inaccessible to me. 

The supplier (Currys) said the 
printer could only run under 
Windows and that a 16 Mb PC 
was probably too small the 
CD would not help me to use it 
otherwise. 

This was confirmed by the 
Epson help line. Currys also 
said that all the makes of 
orinter they sold had similar 
requirements. 

All this strikes me as a 
shocking restraint of trade. 

Can any one confirm that what 
| have been told is true? How 
do other QLers cope? I'm sure 
they cant all be using ancient 
matrix printers: in fact | know 
they aren't. Roy Wood's splen- 
did print of The SBASIC/Super- 
BASIC Reference Manual was 
certainly not produced _ this 
way - nor are his colourful 
invoices; they are so good to 
look at that one quite forgets 
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to complain about prices. (He 
can't possibly be a closet PC 
user - can he?) 

| have a vague memory of 
Jochen writing approvingly of 
an Epson printer some time 
ago. Perhaps they (Epson) 
read his article and decided 
that QL hoipoloi were not 
good for their image and made 
sure we couldn't use the next 
generation of printers. 

| am in dire need of advice and 
instruction; can anyone out 
there help? 

lt has to be said that Currys 
took back the printer and 
refunded the price without the 
slightest fuss. 

Although some printers de- 
scribe themselves as being 
for Windows use only, some- 
times this only extends to the 
instructions or the printer dri- 
ver software supplied. If the 
printer can be used from 
DOS, chances are it could be 
used from the QL, although 
you may have to buy a pro- 
gramming manual costing al- 
most as much as the printer 
itself Other printers are truly 
Windows only and it can be 
very hard to know what to do 
when buying a new modern 
printer 

We have an article in the 
pipeline about learning how to 
program printer control codes 
which we hope will be of 
some help. 

Difficulty with a printer is an 
all too common scenario that 
we hear about. Anyone out 
there willing to help Graham? 
He can be contacted at this 
address: 

Graham Bindon, 

13 Heol-y-Felin, 

Goodwick, 

Pembrokeshire, 

SA64 OAR, Wales. 

Telephone: 01348-874258 


To repeat it once again: the 
cheap models are of no use 
for us. They have to be cheap, 
so the manufacturer saves on 


RAM, EPROM, manual (and 
metal bits of the expensive 
models are made of plastic). 
The better models Stylus 
Color 850 and Color 740 still 
have the full ESC/P2 com- 
mand set and can be used 
from non-Windows systems. 


Bill McKelvey sent us an email: 
~~ You asked for feed- 
< | back (about 2k), 
= audio joke. [I] know 
we wanted new 
ideas for the cartoon, but this 
is ridiculous! - Editor] 
| somewhat agree with Phil 
Stokes. | think we need to en- 
hance the programs that alrea- 
dy exist. But | do believe that 
we can and should change 
new software. The new soft- 
ware should have requirements 
listed. That way you would 
know what hardware it would 
run on. There could possibly 
be 2 versions, one for the plain 
"Black Box’, another for upgra- 
ded QL (Aurora, QPC, QXL, 
etc} 
‘Autolnstall’ is also mentioned. 
This could be a good thing if 
used properly. You should have 
a default set-up, but you should 
be able to change this accord- 
ing to your particular set-up. 
Such as what drive the 
program is stored on, what 
drive the data is on, etc. This 
way for someone with a small 
amount of knowledge they 
coud use the default, explained 
with doc’s. An experienced 
user Could configure it the best 
way for them. 
Joe Hafke has the wrong idea 
as far as | am concerned. He is 
correct when he says there 
are inexpensive computers out 
there. They are called QL’s! 
You can still purchase them at 
shows and from some ven- 
dors. There are still programs 
that are free or shareware 
available. (Gee, almost bundled 
software!) Most of the pro- 
grams that are available are 


QL loday 


easy to use and if you do have 
a problem a phone call, letter 
or even an email will result in a 
quick answer You don't even 
have to pay extra for this ser- 
vice. Try that with a "BIG Blue" 
company, if it is free see how 
quick you get an answer. 

Most people don't need or 
even use all the features that 
they get with their PeeCee. 
Most of it is just keeping up 
with the “Jones's”. [Shall | take 
that personally? - Editor] 

| use a PeeCee at my day job. 
It is very much a pain. It does 
what it wants (when it isn't 
crashing). The programs for 
ALL of the Sinclairs allow US 
to do what we want them to, 
not what they make us do. 
Sorry for being long winded, 
but | am tired of everybody 
saying PeeCee this and Pee- 
Cee that. PHOOWEY 

| 


Imstillen Winkel 12 « 


Minimum order: 3 items (can be mixed)! 


Attachments? 


lan Pizer 


| will use “QL” when | mean any 
configuration of QL, AURORA, 
QXL, QPC, which is based on 
QDOS operating system or 
SMSQ. If you are reading this 
you must be a user of a “QL’. 
lf you are well-informed sender 
or receiver of e-mail with a ‘QL’ 
or PC you can probably save 
time by not reading what | have 
written below. | am writing for 
the amateur user of com- 
munications. 

In Psychology there are 2 
important words which often 
appear together: Attachment 
and Loss. Attachment being 
with people, animals, things, 
places, or situations. Loss 


meaning losing your teddy 
bear your best friend, your 
sibling, your parent, your job, 
etc. (Reference:John Bowlby) 

in QL’ and PC communications 
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| recently learnt about Attach- 
ments. | knew about Loss (lost 
messages}, but what was this 
Attachment thing? When | use 
QTPI with my ‘QL’ (| suppose 
my remarks also apply to other 
communication programs used 
with "QL’), | could send and 
receive text mail messages, 
thanks to my ISP (Internet 
Service Provider) but not Bina- 
ry Files. When reading messa- 
ges with QTPI the Binary files 
were indicated as being pre- 
sent but there was no feature 
in QTPI to transfer them to a 
"QL". The only way | could re- 
ceive binary files was to ask 
the sender to encode the file 
with UUencode or MIME. The 
received encoded file con- 
tained no "Control Codes” and 
could be sent like normal text 
and decoded with the appro- 
priate decoding program. | had 
blamed the deficiency on my 
ISP but now | realise it is a 
facility in QTP! which is missing. 


@ 0203=502011 (rex 0203-502012 Mailbox 0203-502013 & 14) “<a : 

Alternative suppl Ink f 
Ink for — erative supper, este nk for 
EPSON-Printers Canon-Printers 
Stylus 800 sisiaas ccevenene black ........ DM 13,90 BIGG, 3; Mack ds scas ei ecabaleaainamenen DM 9,90 
Stylus Color .........00000, black ........ DM 16,90 BJC 6... Cyan or Yellow or Magenta ... each DM 9,90 
Stylus Color ...........0085 colour ....... DM 27,90 Bl Bi DIG sewn ova cea deensceaea DM 11,90 
Stylus Color Il, lls, 820 ...... black ........ DM 16,90 BIC 8 oie DOCK si acer asaaeaens ti tine wins DM 11,90 
Stylus Color Il, lls .......... colour ....... DM 27,90 BUC4... .colour ......cccccscceecceeseees DM 17,90 
Stylus Color 500,600........ black ........ DM 17,90 BIC8... .black .......cccccccscessueevens DM 14,90 
Stylus Color 500 ........... colour ....... DM 27,90 BJC 8... . Cyan or Yellow or Magenta .. each DM 14,90 
Stylus Color 800, 1520 ...... black ........ DM 23,90 BJ30... black, Pack of 3 ............00005 DM 29,90 
Stylus Color 600, 800, 1520 .. colour ....... DM 34,90 BJ 70... black, Pack of3 .........ccseeees DM 22,90 
Stylus Color 1500 .......... black ........ DM 27,90 BJ70...colour, Pack of 3 ...........s085 DM 27,90 
Stylus Photo ...........0005 colour ....... DM 36,90 


Minimum order: 3 iterns (can be mixed)! 


For postage and payment details see ad on page 13 
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With a PC you also need an ISP 
The ISP provides the connec- 
tion to the Internet or the World 
Wide Web and allows you to 
send and receive mail. When | 
experimented with my PC mail 
facility and my ISP | came 
across the possibility of AT- 
TACHING a file when sending a 
message. The attached file be- 
ing a binary file more or less 
without restrictions (eg. a 
spreadsheet, graphics, sounds, 
programs etc.) or even another 
text file. The mail programs are 
so designed that you can 
attach any file or files you 
choose to a mail message and 
similarly you can receive at- 
tached files. Attachment adds 
considerably to the flexibility 
and power of mail. The pro- 
grams encode or decode a bi- 
nary file automatically using 
MIME (Multiple Internet Mail Ex- 
tensions) or you can choose UU 
encoding. So the process is not 
dissimilar to what | described 


for “QL” but it is all done without 
your technical intervention. 
Using ‘QL’ and QTPI is so easy 
(and | am well familiar with it) 
that | will continue to use them 
for all but the sending or recep- 
tion of binary files. 

The PC communication pro- 
grams do a lot of the con- 
nection work for you because 
they include sophisticated 
“Script’ programs designed to 
handle most situations. Jona- 
than has provided a set of 
Script programs so that they 
can be used with QTPI to sim- 
plify connections. However | 
have spent many hours trying 
to utilise his Script for my ISP 
(Compuserve) with notable 
failure. Pity! My limits were 
shown up there. Probably one 
could prepare a Script program 
to send or receive binary files 
with QTPI. It would pick up your 
binary file, pass it through MIME 
then add it to your text mes- 
sage and Bob's your Uncle. But 


The future-proof QL clock 


Mark Knight 


On reading the November 
December 1998 edition of QL 
Today | was interested to read 
W. PJ. Baily’s contribution about 
the DATE problem with QDOS 
and SMSQ/E. While writing my 
own File Manager program | ran 
into this problem and solved it. 
The problem stems from the 
fact that the QDOS date 
arithmetic routines treat the 32 
bit value from the QL clock 
chip as an unsigned 32 bit long 
integer, which is fine because 
that is how the clock chip 
works. The SuperBASIC inter- 
preter treats all 32-bit integers 
as signed 32-bit values. When 
the clock ticks up from 
2,147,483,647 to 2147,483648 
the interpreter regards it as 
-2147,483,648 since the top- 
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most bit is treated as the sign 
bit and the number becomes a 
twos complement negative 
value. As far as SuperBASIC is 
concerned the clock now 
counts upwards from this value 
towards -i, when at 0 it will 
wrap around to 1960 again. 

lf you type: 

print date$(2147483647) 
the QL will reply with: 

2029 Jan 19 03:14:07 

which is correct. Typing: 
print date$(2147483648) 
Will produce an overflow on a 
JS ROM and on most other 
systems. This is natural as the 
SuperBASIC floating point 
structure cant store — this 
number correctly. To obtain a 
correct answer type this 
instead: 


unless you are a skillful pro- 
grammer you may well fail too. 
Any programmers out there? 
Finally, what exactly ts a binary 
file? A binary file consists basi- 
cally of ones and zeros but can 
be visualised by groups of 8 
binary bits (bytes) but what you 
find are not ASCII characters; or 
it can be visualised as 16 bits 
(hexadecimal) which also does 
not have a direct meaning. 
Same time back | had a hot dis- 
cussion by e-mail with an un- 
known {io me} mailer called 
Spike H. about the difference 
between a binary file and a 
non-binary or pure text file. We 
ended by agreeing to disagree. 
Seems to be a hot subject. 
Another way of transferring 
binary files is to use a protocol 
called FTP (File Transfer Pro- 
tocol). Presumably FTP does 
not need to do encoding 
(maybe sends the binary bits 
serially). 

a 


print date$(-2147483648) 
print date$(-2147483647) 
and you will obtain: 

2029 Jan 19 03:14:08 

2029 Jan 19 03:14:09 

Which might seem a little odd 
but it is also correct. You are 
feeding the DATES function 
signed integer values and it 
treats the value as an unsigned 
one, so the sign bit is just 
another bit and increases the 
value internally, 

This proves that DATES works 
properly, but the ridiculous 
thing is that DATE doesn't. It 
does something silly in con- 
verting the unsigned 32 bit 
value read from the clock chip 
to a floating point number, so 
after the clock ticks past 2029 
Jan 19 03:14:07 DATE gives 
wrong values. Irritated, | wrote 
a patch called Date_FIX which 
replaces the DATE function 
with one that works; all you 
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have to do is load it using 
LRESPR or the  RESPR, 
LBYTES and CALL sequence 
and your SuperBASIC — or 
SBASIC clock routines will 
work properly from 1960 Jan 
O1 00:00:00 right up to 2097 
Feb 06 06:28:15, at which point 
if you are still alive you are 
most unlikely to be bothered 


When writing SuperBASIC or 
SBASIC programs you have to 
count from QO up to 
2,147,483,647 as the first part 
of the date sequence, then 
from -2,147,483,648 up to -1 as 
the second part. This also 
makes comparing dates awk- 
ward in SuperBASIC, but I've 
solved that problem too. Try 


whether your QL clock still — this a few times: 


works. 


100 BORDER 1,2 

110 CLS 

120 FirstDate=RND * 1E9 + RND * -1E9 

130 SecondDate=RND * 1E9 + RND * -1E9 

140 PRINT DATE$(FirstDate) , FirstDate\DATE$(SecondDate), 
SecondDate 

150 IF (FirstDate<0 AND SecondDate<0 AND FirstDate< SecondDate) 
OR (FirstDate»=0 AND (FirstDate«SecondDate OR SecondDate< 0) ) 
THEN 

160 REMark FirstDate is earlier 

170 PRINT "First chosen date is earlier" 

180 ELSE 

190 REMark SecondDate is earlier or the same 

200 PRINT "Second chosen date is earlier or the same" 


210 END IF 


.you won't catch it out, at least 
not on a JS ROM QL, and al- 
though | haven't tested it | ima- 
gine it will work in all the Super- 
BASIC and SBASIC  environ- 
ments. You are welcome to use 
this code to compare dates in 
your Own programs, but be 
careful if typing your own ver- 
sion, as all the brackets and 
comparisons on line 150 must 
be exactly right for the code to 
work. 

Now with the SuperBASIC 
comparison of dates working 
and knowing as we do that 
DATES works, it's time to fix 
DATE so the assembly lan- 
guage is listed below for those 
with an assembler Once as- 
sembied you will end up with a 
small file that should be loaded 
in your boot program using 
LRESPR or similar, it is 96 bytes 
long and once loaded DATE will 
work right up to 2097 Feb 06 
06:28:15. 


* Working version of the QL DATE function as written by Mark Knight. 


* Thanks to Simon N Goodwin in DIY Toolkit series 
* for 32-bit long integer to floating point conversion routine. 
* 


Start MOVE.W $110, A0 $110 = BP.INIT vector 
LEA.L Defines, Ai Load definition address into AL 
JMP (AQ) jump to BP.INIT it will return to caller 
% 
Main MOVE. L #$13,DO Select MT.RCLCK routine. 
TRAP #1 Call it to fetch 32-bit value in D1. 
x 
Di_Ret MOVE.W D1, D4 D4 will be exponent. 
MOVE. L D1, D5 D5 will be mantissa. 
BEQ.S Norlised Zero is a trivial case. 
MOVE.W #2079, D4 First guess at exponent. 
ADD.L D1,D1 Is it normalised? 
BVS.S Norlised If so, return it. 
SUBQ.W #1,D4 Not ready, halve exponent. 
MOVE. L D1,D5 Doubled mantissa moved to D5. 
MOVEQ #16,D0 Try 16 bit shift first. 
% 
Normalise MOVE.L D5,D1L Make copy of mantissa. 
ASL. L DO, DL Shift mantissa DO places left. 
BVS.S Too_Far Try next shift distance. 
SUB.W DO, D4 correct exponent for that shift. 
MOVE.L Di, D5 New mantissa is closer. 
Too_Far ASR.W #1,D0 Half the shift distance for next try. 
BNE.S Normalise Half the previous shift each time. 


% 


* Make sure there is enough space for the result. 
¥ 


Norlised MOVEQ #6,D1 Number of bytes needed is 6. 
MOVE. W $114, A0 Select BV.CHRIX to reserve space. 
JSR (AQ) Call the routine 
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MOVE.L $58(A6), AL 
SUBQ.L #6,A1 
MOVE.L A1,$58(A6) 
MOVE.L D5,2(A1,46.L) 
MOVE .W D4, 0(A1, A6.L) 
MOVEQ #2,D4 
MOVEQ #0,D0 
RTS 
x 
Defines DC.W 0 
DC.W 0 
DC.W sh 
DC.W Main-* 
DC.B 4 
DC.B "DATE! 
DC.W 0 
END 


UNIX-ifying QDOS 


Tim Swenson 


Fetch safe Al value. 
Point to the new value. 
update stack pointer. 
Stack the mantissa. 
Stack the exponent. 


Indicate floating point result. 


Indicate no error. 


No PROCedures 

End of PROCedure list. 

One FuNction 

Position of code for FuNction 
Length of name 

Characters of name 

End of FuNetion list 


Recently a number of Unix utilities have been ported to QDOS. 
Given my background in Unix, | started thinking about how Unix- 
like one could make the QL. Using a number of utilities, could | 
make my QL “feel” like a Unix system? 


Now before | hear cries of non- 
Sinclairism, let me say that Unix 
is my “bread and butter’. I've 
been using and maintaining 
Unix systems professionally for 
about 10 years. Also, next to 
QDOS, Unix is my next favorite 
operating system. It’s not great 
for desktop systems, but for 
servers it rocks. 


The first step in my Unix-like 
quest is a shell. A shell, or 
command interpreter, is the part 
of an operating system that 
handies the interaction bet- 
ween the OS and the user. In 
MS-DOS terms, COMMAND.COM 
is the shell. In QDOS, the shell 
is really SuperBasic. In Unix 
there are a number of shells, 
Bourne, C, 1 and Korn. For 
QDOS, Adrian Ives has refined 
a shell, called simply The Shell, 
originally started by PJ. Taylor 


The biggest advantage in using 
The Shell is the way that you 
can execute programs. QDOS 
does not allow command-line 
arguments and they have been 
kludged in Toolkit Il. In QDOS 
executing a program with com- 
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mand-line arguements is done 
like this: 
execunzip;"flp1_file_zip" 
Where as in The Shell, it is 
executed like this: 

unzip flpl_file_zip 

There is no need for the exec 
(it is implied) and any number of 
arguments can come after the 
executable file name. This may 
sound trivial but it really does 
affect the feel of the operating 
system. 

The Shell supports the Unix 
convention for creating pipes. 
Pipes are allowed in QDOS, but 
| don't think many people use 
them. In Unix, pipes are a vital 
core of the OS. An example 
taken from the TKI] manual is: 
EX uc, fred TO lno TO page, 
ser;'File fred at'&date$ 
Unix uses the vertical bar (| }, 
called the pipe sybmol, instead 
of TO. An example pipe would 
be: 

cat file_txt | grep string | 
we - 

This would copy a file to a pipe, 
pass it to the ‘grep’ command 
and look for the word ‘string’ in 


For those without an assem- 
bler the Date_FIX file should be 
on the next QL Today cover 
disk along with the Super- 
BASIC listed above - oh yes, 
and a calendar program that 
works with the QL clock and 
runs happily from 1960 Jan Oi 
00:00:00 right up to {yes, 
you've guessed it) 2097 Feb 06 
06:28:15 with Date_FIX loaded. 
| hope everybody's happy now 
- and if not contact me in 2096 
if you're still able and I'l see 
what | can co... 


the file, reporting only those 
lines that had the string, and 
pass the results to ‘wc’ (word 
count) where it would count the 
number of lines that came from 
the ‘grep’ command. Pipes al- 
low you to string a number of 
commands togther saving the 
need to create output files for 
each command. This also 
works kind of like program 
ming. If need a tool to do such 
and such, sometimes you can 
string togther a number of 
commands, via pipes, to get 
the same results. 


The Shell also supports the 
background job character/com- 
mand of Unix. In QDOS we 
have EXEC_W and EXEC, 
where EXEC runs the job ‘in 
the backgound’ and returns the 
keyboard to SuperBasic. In 
Unix the difference is done with 
the ampersand symbol (&). If 
you want to run a Unix com 
mand in the background, you 
would end the command line 
with an ampersand. 


The Shell uses Level-2 directo- 
ries the same way the Unix 
does. | can ‘cd bin’ to get to a 
directory called bin. | can also 
‘cd / to get the the root 
directory. If | am in the bin 
directory and! want to get into 
a different directory at the 
same level, | can do ‘cd ../man’ 
or ‘cd /man’.. Both commands 
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would take me to the same 
directory. 

A number of Unix commands 
are built into The Shell. They 
are: 

cd - change directory. 

md - make a directory. 

kill - Remove a job. 

alias - rename or create com- 
mands. 

The Shell allows for shell 
scripts. These are files that 
contain a number of Shell com- 
mands and can be used like 
programs and help automate 
some tasks. 

The Shell also comes with a 
few external executables to 
work like Unix commands. |s’ is 
similar to WDIR, ‘lenv' is similar 
to the Unix ‘setenv’ and the 
QDOS ENV_LIST. ‘Is’ is kind of 
neat in that it makes QL 
subdirectories look like real 
subdirectories. If you are in a 
subdirectory, it displays the files 
in the directory, but does not 
append the directory name to 
it. 

Also available from Adrian 
lves’'s web page is RKUtils.zip, 
a set of utilities by Richard 
Kettlewell. From it comes a 
number of executables, with 
only a few having the same 
name as Unix commands; cat, 
tsort, & sort. ‘more’ Is listed in 
the documentation of the 
RKUtils, but it is not in the 
distribution. 

| now start trolling various free- 
ware distributions for any Unix- 
like executables. From the C68 
distribution comes touch, make, 
cp, rm, fgrep, grep, uue, uud, 
tsort, sed, & diff The primary 
commands here are: 

touch - create a new empty file 
or update the date on a file. 

cp - copy file(s). 

rm - remove file(s). 

grep - search a file(s) for a 
string. 

From the Gnu Text Utilities 
comes the following com- 
mands: 
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we - word count. 

cut - pull characters from lines 
in a file. 

head - display the first few lines 
of a file. 

tail - display the last few lines 
of a file. 

tr - translate one character for 
another. 

unig - output only unique lines 
from a file. 

cmp - compare. compares two 
text files. 

expand - convert tabs to spa- 
ces. 

fold - fold long lines for finite 
width output device. 

join - creates a union between 
text files. 

paste - merge same lines of 
several files. 

split - splits a file into a number 
of files. 

unexpand - convert spaces to 
tabs. 

sum - print checksum and 
block count of a file. 

With these commands, | have 
the start of a basic Unix com- 
mand set. Now | can create 
files (touch), delete them (rm), 
and copy them (cp). | just nee- 
ded a way to edit text files. The 
standard Unix text editor ts ‘vi, 
pronounced ‘vee-eye’ not “six” 
(for the Roman numerals). A 
clone of ‘vi elvis, has been 
ported to the QL. Using an 
‘alias’ | can make elvis appear 
as ‘vi. The alias Is: 

“ALIAS VI=ELVIS $- 

The $- tells ‘alias’ fo pass to 
elvis the rest of the command 
line. This way elvis will know 
which file to edit. 

Another editor that can be 
found on Unix and QL systems 
is MicroEmacs. Although not 
specifically a Unix application, it 
has been ported to Unix 
amongst many systems. 

There are also a number of 
utilities that are used in Unix 
that are in their own distribution. 


Peter Tiller has ported over 
AWK and SED. AWK is a nice 
utility language for handling co- 
umn data in text files. In an act 
of sure perversion, | did see a 
LISP intepreter written in AWK. 
This shows that the langauge 
can be fairly useful. | don't 
know what functional differen- 
ces Peter's SED has over the 
one distributed with C68. 
About the most imporant Unix 
utility ported to the QL so far |s 
Perl. Perl is THE Unix utlity 
language. It is used from writing 
System Administration — pro- 
grams, to writing CGl-bin 
scripts that are the data en- 
gines behind web pages. This 
language can practically do it 
all Jonathan Hudson has 
answered the wish of many a 
QDOS/Unix user by porting 
Perl 4 to QDOS. 


Other Unix tools that have 
been ported are: 

PGP - Pretty Good Privacy, 
THE encryption program. 

RCS - Revision Control System, 
a tool handling source code 
revision control. 

REXX - Another utility lan- 
guage (don't know much about 
it), 

BISON & LEX - 
creating compilers. 
GZIP - Gnu ZIP a_ popular 
compression tool. 

TAR - The standard archival 
tools for Unix. 

Curses - a C library for screen 
control. Curses-based — pro- 
grams allow protable text gra- 
phics across many terminals 
and systems. This library allows 
curses-based programs to be 
ported to the QL from Unix. 
GhostScript - displays Post- 
script & Adobe Acrobat files. 
Because these programs have 
been compiled with C68, they 
have a way of knowing of they 
are being called by a ‘shell’ and 
then they pass back their 


tools for 
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Gold Card / Atari / QXL Version 


Various Atari versions : call for details 


OPC : 
Shop hours :| | £ 90.00 (£ 70.00 SMSQ/E Owners) 


Mon - Fri With CUESHELL Module : 


| 0am - 6pm £ 110.00 (£ 90.00 SMSQ/E Owners) 


Wed / Sat We can now supply colour laptops with QPC already 
10am - 2pm installed ! The systems are secondhand and vary 
eee considerably so you will need to call for details but 
a typical starting price for a 486 DX 70 Toshiba with 
350 Meg hard disk and 12 Ram complete with QPC 
and Carrying case is 


(+postage ) 


The Q 40 is finally 
here ! 

By the time that you 

| read this we should be 


aio the Qa the” =| | PROGRAMMING 


UTILITIES 


FiFi 2 £22.00 
QSup £32.00 ae 

kage will include D 98 £53.00 
QSpread v1.44 £66.00 16Mb Ram (upgradable Q ; 
Cueshell 2 £30.00 to 32Mb) we VO QD + QBasic £ 69.00 


Qload/Qref £15.00 : card. Final pricing was QD + Qliberator + QBasic £ 110.00 


decided ‘ber 
Disk MateS £16.50 | ike time of suits io Qliberator £50.00 
QPAC 1 £ 20.00 _ Press but the upper Master Spy v 3.3 £ 30.00 
Qpac2 £40.00 | Rit for, the board wail | gpTR £37.00 
QTYP 2 £30.00 could be a lot lower if Easyptr pt 1 & 2 (together) £ 33.00 
QLO £32.00 we cn get ne deals Easyptr pt 3 (C library) £16.00 
LDUMP £ 26.00 Ta aiaoie: | QMake £ 18.00 
Q Count £ 25.00 If you want one of QMon/]Mon £22.00 
— nee ey machines Basic Linker £ 22.00 
then—-eentact us. e 

Text 87 first 25 ong to DISA 3 £ 37.00 
place a cheque, or QMenu £ 16.00 


credit card details ‘:with 
v us will receive free 
ROM upgrades and, 
other preferential deals. 
“No money will be | 


| £79.00 
|Typset 94 £29.00 
|Fountext 94 £39.00} 
| 2488 drivers £ 29.00) 
|Epson ESC/P2 drivers, 
£ 26.00 


‘Just Words' by Geoff Wicks 

bad lant 4 | THESAURUS, STYLE CHECK, SOLVITPLUS 3 
per ees bog we i » £15.00 ea/ ANY 2 PROGRAMS £ 25.00 / ALL 3 PROGRAMS £ 35.00 | 
This coming year showld | THESAURUS V4.01 / SOLVIT PLUS 3 v 3.00 
be a._pivotal one for 


Pointer drivens versions of Geoff Wicks popular programs. 


Text 87 is the only QDOS/ | 


QDO cm users and (needs Hot_rext, WMAN and PTR_GEN or SMSQ/E to run } 
| SMSQ wworelpracesser . any new “things vare Still the same price £15.00 
/ Cepaple Or panelung De ey eing plar ds Upgrades from previous versions £ 2.50 + S.A.E. 


i screen on the Aurora /QXL/} 
i QPC systems. New drivers | 
| are currently being written. | 
| WATCH THIS SPACE ! 


A Happy New Year to 


ail of out. Cukto tienen Spelling Crib : PD program £ 1.50 +SAE 


or Free if you buy all three programs 


— 4 = . ; e e . 7 . — 7 ™ 
Youve been asking for it and here it is ! Over 500 


| The SBASIC / SuperBASIC Reference Manual pages | 
| The complete definitive guide to BASIC programming in QDOS / SMSQ including | £ AO.00 
three disks of PD toolkits, example procedures and an electronic index. 
compiled by Rich Mellor, Franz Hermann and Peter Jaeger 


| + postage 


38 QL Today 


ya 


: [ Tel +44 (0) 1903-200212 fax +44 (0) 1903-208070 
: email qbranch@qbranch.demon.co.uk web : hitp:/w~).qbranch.demon.co.uk 


O Branch 
Feeling out on a limb ? 


Reach out for 0 Branch. 
Suppliers of Quality QDOS/SMS@ products 


The Bank Volt, 6 Coronation Buildings 
Ham Road, Worthing. 2 
W. Sussex. BN11 2NN. UK. On board Sound / Graphics / Keyboard § 
ea nares Interfaces 
Hardware | 16 Mb Ram, full 68040 processor (fs aug 
QXL I £180.00 | V/O card with floppy and hard disk support 
sacs An ps aoa ‘ pane The fastest QL Hardware yet ! 
Aurora £ 100.00 Special deals for the first 25 pre-orders. 
Qubide £55.00 Call us for details. 


Qplane £ 25.00 
Aurora cables £3.00 
Aurorarom adaptor £3.00 


The 'Braquet' £ 16.00 
* when available. 


ProWesS 


ProWesS 
DATAdesign 
Fontutils 
File Search 
PFlist 
Fontpack 


25 pin D sockets 


All the socket holes you will ever need on the back of 
your tower case. Just rip off the silly PC thing and screw 
_ on this one. No cutting needed. What could be easier ? 


LINEdesign v 2.16 


PWfile . ) . 
Q Branch Programs 


P ackage de al S The Knight Safe 1 - standard version £ 30.00 
| | The Knight Safe 2 - with compression £ 35.00 
QXL II + SMSQ/E £ 220.00 Oxthiini £25.00 

| Aurora + SMSQ/E £160.00 | Pointer driven home accounting 
Q - Route v1.07 £ 25.00 


| Above package + Monitor £ 380.00 Route finding programme 


| Ready for use and giving all screen resolutions from 512 x 256 to 1024x576 | 
e e f f } \ 
—- £40.00 + shipping Only a few left. _) 


We can accept payment by VISA, Mastercard and Switch. You can also pay by| 
Eurocheques made out in Sterling or a Sterling cheque drawn on a UK Bank.| 
Prices include Post and Packing in Europe. 


2nd user 14" SVGA Colour Monitors 1 (suitable for Aurora) 
| 
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output back to the shell to 
display, instead of opening up a 
new window. This creates a 
very Unix-like display. 

There were some Unix com- 
mands that are not ported to 
the QL but | was able to find 
some equivalents. ‘set’ is equi- 
valent to SETENV and is called 
‘let’ in The Shell. ‘pwd’ tells you 
what directory you are in. It can 
be created using the ‘alias’ 
command: 

“ALIAS PWD=PRINT $(%DATA) 
clear’ is the same as QDOS 
CLS and called CLS in The 
Shell An ‘alias’ of ALIAS 
CLEAR=CLS will do the trick. 
mv’ (move / rename) can be 
done by using the RKUtils 
command ‘Ren’ and give it a 
new name via an alias: 

“ALIAS MV=REN $ 

For the Unix ‘mkdir’ and alias 
using The Shell's ‘md’ would 
be: 

“ALIAS MKDIR=MD $ 

What | need to find now is an 
equivalent to the following: 

ps - List jobs. 

du - the equivilent of QDOS 
STAT. 

Now, Im not recommending 
that all QDOS users need to 
get The Shell and start using 
their QL’s like a Unix system. 
What | am getting at is for 
those of us familair with Unix, 
here is a way to work with 
something we are used to. 
Since | think in both QDOS and 
Unix, sometimes | find it easier 
to do something in Unix than | 
would using QDOS and non- 
Unix utilities. Since | bang away 
on a Unix system 8 hours a day, 
i's nice fo come home and 
have my QL adapt itself to fit 
my needs. | doubt | will exclu- 
sively use The Shell to work on 
the QL. 

a 
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Hard Disk Utilities 


Dilwyn Jones 


Way back in my Recursion 
article in Volume 1 Issue 3 | ex- 
plained the subject of recursion, 
and one of the example rou- 
tines given was an Extended 
DIR routine, for listing out files in 
directories on a hard disk. 

In these example routines, | will 
extend this routine to provide 
useful little hard disk utilities. 
These came about because | 
needed utilities to provide 
these functions. The resultant 
BASIC programs are fairly 


short and show just what can 
be achieved in a language like 
SuperBASIC on the QL. 

1. MAKEDIRS_bas is a short 
routine which can generate a 
BASIC program which will 
recreate the directory structure 
of your hard disk with a series 
of MAKE_DIR instructions. Run 
the generated program before 
restoring a backup if your 
backup program does not 
create the subdirectories for 
you. 


100 REMark extended dir of all sub-directories 


110 CLS : CLS #0 
120 INPUT #0,'Drive > ';dr$ 


130 INPUT #0,'Create program called > ';prg$ 


140 lineno = 100 


150 OPEN_NEW #3,pre$ : REMark create the BASIC program 
160 PRINT #3,line_no;' REMark reconstitute directories of ';dr$ 
170 PRINT line_no;' REMark reconstitute directories of ';dr$ 


180 line_no = line_no + 10 
190 Extended_DIR dr$,'! 


200 CLOSE #3 : REMark finished making the program 


210 : 


220 DEFine PROCedure Extended_DIR (drive$, directory$) 


230  LOCal loop, ch, d$, fp,n$ 


240 ch = FOP_DIR (drive$&directory$) : REMark open channel to directory 


250 IF ch«< 0 THEN RETurn : 


REMark unable to open directory 


260 fp =14: REMark file position in directory for filename 


270  REPeat loop 


280 BGET #ch\fp : IF EOF(#ch) THEN CLOSE #ch : EXIT loop 
290 GET #ch,d$ : REMark get directory entry name 


300 ‘IF LEN(d$) » 0 THEN 


310 REMark a directory length of 0 may be a deleted file 

320 BGET #ch\fp-9 : REMark file type byte 

330 IF CODE(INKEY$(#ch)) = 255 THEN 

340 REMark this name is a subdirectory, so we need to DIR this 
350 REMark if you want directory names printed, add this 


360 REMark PRINT d$;' ->! 


370 REMark write a line of BASIC 
380 PRINT line_no;' MAKE_DIR ';drive$;d$ 
390 PRINT #3,line_no;' MAKE DIR ';drive$;d$ 


400 line_no = line_no + 10 
410 Extended_DIR drive$,d$ 
420 ELSE 


430 REMark next line can be used to list all files 


440 REMark PRINT d$ 
450 END IF 

460 END IF 

470 «fp = fp + 64 

480 END REPeat loop 


| 490 END DEFine Extended_DIR 
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2. TREES_bas prints an inden- 
ted listing showing the subdi- 
rectory tree structure of your 
hard disk. 


3. LOCATE_bas is a simple file 
finder | placed an important QL 
Today file in the wrong direc- 
tory on my hard disk, and 
thought I'd lost it. This little pro- 
gram quickly found it for me. 
As well as finding filenames for 
you, It can also be used to list 
fle types - for example, to 
locate all Quill DOC files, just tell 
it to search through WIN1_, 
listing files ending with _DOC. 
Or if you know the filename, 
enter that as the name to 
search for it'll list any direc- 
tories containing files which 
end with the name entered. 


4, DCOPY_bas copies an enti- 
re directory and its subdirec- 
tories, creating the directory 
Structure elsewhere as it goes, 
Beware of copying long file- 


100 REMark extended dir of all sub-directories 8) 


110 CLS : CLS #0 


120 REMark search for filename - do not enter drive name! 


130 INPUT #0,'Search for >» ';f$ 

140 INPUT #0,'On drive » ';dr$ 

150 INPUT #0,'From directory » ';dre$ 
160 Extended_DIR dr$,dre$ 

170: 


180 DEFine PROCedure Extended_DIR (drive$,directory$) 


190 LOCal loop, ch, 4, fp, n$ 


200 ch = FOP_DIR (drive$Sdirectory$) : REMark open channel to directory 
REMark unable to open directory 
220 fp = 14: REMark file position in directory for filename 


210 IF ch« 0 THEN RETurn : 


230 REPeat loop 


240 BGET #ch\fp : IF EOF(#ch) THEN CLOSE #ch : EXIT loop 
250 GET #ch,d$ : REMark get directory entry name 


260 IF LEN(d$) » 0 THEN 


110 CLS : CLS #0 

120 INPUT #0,'Drive >» ';dr$ 

130 INPUT #0,'Directory >» ';drce$ 

140 PRINT dr$ 

150 Extended_DIR dr$, dre$,0 

160 : 

170 DEFine PROCedure Extended_DIR (drive$, directory$,dpth) 

180 LOCal loop, ch,d$, fp,n$ 

190 ch = FOP_DIR (drive$&directory$) : REMark open channel to directory 
200 IF ch« OQ THEN RETurn : REMark unable to open directory 
210 fp = 14: REMark file position in directory for filename 
220 REPeat loop 

230 BGET #ch\fp : IF EOF(#ch) THEN CLOSE #ch : EXIT loop 
240 GET #ch,d$ : REMark get directory entry name 

250 IF LEN(d$) » 0 THEN 


100 REMark extended dir of all sub-directories Q) 


| 260 REMark a directory length of 0 may be a deleted file 
270 BGET #ch\fp-9 : REMark file type byte 
280 IF CODE(INKEY$(#ch)) = 255 THEN 
290 REMark this name is a subdirectory, so we need to DIR this 
300 REMark if you want directory names printed, add this 
310 REMark PRINT d$;! ~>! 
320 FOR a = 0 TO dpth 
330 PRINT 'j'; : IF a dpth THEN PRINT’ '; : ELSE PRINT 
340 END FOR a 
350 FOR a = 0 TO dpth-1 
360 PRINT '|'; : IF ac dpth THEN PRINT! |; 
370 END FOR a 
| 380 PRINT '4-'3d$ 
390 line_no = line_no + 10 
400 Extended_DIR drive$,d$, dpth+1 
410 ELSE 
420 REMark next line can be used to list all files 
430 REMark PRINT d$ 
440 END IF 
450 END IF 


460 fp = fp + 64 
470 END REPeat loop 
480 END DEFine Extended_DIR 


names from a directory into a 
directory with a longer name 
and exceeding the QL filename 
length limit of 36 characters 
plus drive name! 

These programs will compile 
with QLiberator Compile with 
WINDS on. It might be advis- 
able to add a line to make the 
program pause before it stops, 
so that you can view the 
results - adding a line such as 


270 REMark a directory length of 0 may be a deleted file INPUT#O, 'Program Finished, 

280 BGET #eh\fp-9 : REMark file type byte ie 

290 IF CODE(INKEY$(#ch)) = 255 THEN press ENTER ';2$ _ 

300 REMark this name is a subdirectory, so we need to DIR this just before the DEFine PRO- 

310 REMark if you want directory names printed, add this j 

320 REMark PRINT '* Searching ';d$;! -»! Cedure Extended_DIR _ line 

330 Extended_DIR drive$, d$ should accomplish this. | have 

aan ar ae ie not tested it with Turbo or 
ar. oes 1s mate z 

360 REMark containing f$: Supercharge. 

370 REMark IF f$ INSTR d$ : PRINT d$ All programs require the use of 

380 TF LEN(d$) >= LEN(£$) THEN Toolkit 2. As QDOS/SMSQ 
IF d$(LEN(d$)-LEN(£$)+1 TO LEN(d$)) == f$ THEN PRINT d , ; 

is END A eee os : systems supporting directories 

410 END IF tend to support the Toolkit 2 

fe > ND TE extensions, this was not 

430 fp = fp + 64 ; 

440 END REPeat loop thought to be a major problem. 


450 END DEFine Extended_DIR 
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100 REMark copy entire disk, subdirectories and all 

110 CLS : CLS #0 4 
120 INPUT #0,'Copy from which drive > ';dr$ 

130 INPUT #0,'Copy to which drive » ';tdr$ 

140 Extended_DIR dr$,!' 


150 : 


160 DEFine PROCedure Extended_DIR (drive$, directory$) 


170 LOCal loop,ch,d$,fp,n$ 


180 ch = FOP_DIR (drive$&directory$) : REMark open channel to directory 


190 IF ch« 0 THEN RETurn : 


REMark unable to open directory 


200 fp = 14: REMark file position in directory for filename 


210 REPeat loop 


220 BGET #ch\fp : IF EOF(#ch) THEN CLOSE #ch : EXIT loop 
230 GET #ch,d$ : REMark get directory entry name 


240 IF LEN(d$) > 0 THEN 


250 REMark a directory length of 0 may be a deleted file 
260 BGET #ch\fp-9 : REMark file type byte 

270 IF CODE(INKEY$(#ch)) = 255 THEN 

280 REMark need to create this directory in destination 


290 PRINT! Creating ';d$;'... 


' : MAKE_DIR tdr$ad$ 


300 REMark follow the directory tree 


310 Extended_DIR drive§$, d$ 
320 ELSE 


330 REMark next line can be used to list all files 


340 PRINT Copying ';d$;'... 


350 END IF 

| 360 END IF 

370 fp = fp + 64 

380 END REPeat loop 

390 END DEFine Extended_DIR 


' : COPY dr$&d$ TO tdr$ka$ 


Paragraph v1.01 - a first look 


PBailey 
This is a free initial version of a new word processor for 'QL 
type’ computers; it is designed to operate in the 'ProWesS' 

environment. 


| obtained a copy by down- 
loading ‘PARAGIO1_ZIP’ from 
JMS BBS. The _zip file expan- 
ded into 10 files: 

smallheader _lay; 

fax_lay; 

headerfooter_lay; 
largeheader _lay; 

default_lay; 

README _first; 

register _txt; 

pafagraph_exe; 

changes_txt and 
example_parg. 

All but the ‘paragraph_exe’ file 
showed the warning ‘skipping 
unknown (non QDOS) field” on 
decompression but | pressed 
on. Apparently nothing was 
missing. The ‘lay’ files are 
page layouts and '_parg’ is the 
(default) extension for a com- 
pleted document. 
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After setting SYSTEM-DRAG- 
TEST-TIMEOUT (ProWesS con- 
figuration) to a value above 10 (| 
used 15 and tested 20 which 
appears to be too large) as 
instructed in ‘README_first’, | 
set up a special boot file, 
identical to one | use for 
'LINEdesign’, to give me the 
‘utilities’ multibutton, the clock, 
the ‘applications’ multibutton 
and QPAC2. Programmes 
which could be called via the 
‘applications’ multibutton were 
‘ProWesS_ Reader’, ‘PWfile’. 
‘PARAGRAPH’ and ‘Editor SE’. 
After resetting and loading 
‘SMSQ/E’, | ran the boot file and 
when | called ‘PARAGRAPH’ 
from the ‘applications’ multibut- 
ton the PARAGRAPH’ screen 
duly appeared. 


The screen has a two row 
menu bar The top line of the 
menu bar shows ‘HELP’ (not yet 
available). OPTIONS: the cur- 
rent file name (programme 
name at first) ‘QUIT’ and sleep 
buttons. The second line 
shows ‘Files; ‘Print; ‘Edit’ 
Layout; ‘View’ each of which 
has sub-menus, followed by 
icons for selection of font: font 
size; colour of paper ink and 
strip; underline toggle; justifica- 
tion; margin setting; and para- 
graph indenting with leading 
bullet (‘hit to get, ‘do’ to cancel} 
and, to the right of a page num- 
ber indicator up and down ar- 
rows for changing to next or 
previous page. Below this the 
screen shows the top part of 
an A4 page outlined in black 
with its text areas outlined in 
red. There is a scroll bar at the 
right-hand side. The pointer is 
in the form of a large |’ and the 
cursor is a vertical line appear- 
ing initially at the start position 
(default left-hand margin) on the 
top line of TEXT #1 area. 

| found to my surprise that | 
could not enter text directly 
and | have not yet found out 
why. However | was able to 
‘insert text’ (Files Menu) and 
proceeded to do so using the 
README first’, ‘changes_txt 
and ‘register_txt'files provided. 
README_first’ was 3 pages 
and switching to the required 
page was selected by a ‘hit’ on 
the ‘Page’ window and again 
on the relevant number in a 
sub-menu window which ap- 
pears. However the selected 
page appeared only on scrol- 
ling the page in the window. | 
was able to print the pages via 
the ‘Print’ menu (the PROforma 
default driver no selection of 
driver yet). The other ’_txt’ files 
(one page each) also imported 
and printed successfully. The 
default font and font size seem 
to be ‘Bitstream Charter’ at 10 
point. 
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TF Services 


superHermes 


A major hardware upgrade for the QL 

° All Hermes features (see below for list) PLUS full 19200 
throughput on serl/ser2 not affected by sound 

* IBM AT kevboard interface (plus foreign drivers) 

* HIGH SPEED RS232 industry standard two-way serial port. 
4800cps throughput (supergoldcard - qtpi - zmodem) at 
$7600bps 

* THREE low speed RS232 inputs (1200 to 30bps) Driver for 
SERIAL MOUSE supplied. Other uses include RTTY/ 
graphics tablet etc 

° THREE spare I/O lines (logic) with GND/+5V 

® Capslock/scrollock LED connector 

* Turbo/keylock connectors 

* 1.5k user data permanently storeable in EEPROM 

All this on a professional board about twice the size of 


the 8049 co-processor it replaces 
Cost (including manual/software) £90 (£92/£87/£90) 


IBM AT UK layout Keyboard £22 (£24/£23/£27) 
Serial mouse .....00.00000000000ccc ee. £11 (£13/£12/£14) 
Capstock/scrollock LED £1 (£1.50/£1/£1.50) 
Kevboard or mouse lead £3 (£3.50/£3/£3.50) 
High speed serial (ser3) lead £4 (£4. 50/£4/£4.50) 


Hermes available for £25 (£26/£24/£27) Working ser1/2 
and independent input, debounced keyboard & keyclick. 


superHermes LITE 


All Hermes features (see above) + an IBM AT 
keyboard interface only. Entry level superHermes. 
Cost (incl keyboard lead)...£53 (£55.50/£51/£53.50) 


Minerva 


MINERVA RTC (MKII) + battery for 256 bytes ram. 
CRASHPROOF clock & I°C bus for interfacing. Can 
autoboot from battery backed ram. — Quick start-up. 


The ORIGINAL system operating system upgrade 


OTHER FEATURES COMMON TO ALL VERSIONS 
DEBUGGED operating system/ autoboot on reset of power 
failure/ Multiple Basic/ faster scheduler- graphics (within 
10% of lightning) - string handling/ WHEN ERROR/ 2nd 
screed TRACE/ non-English keyboard drivers/ “warm” 
fast reset. V1.97 with split OUTPUT baud rates (+ Hermes) 
& built in Multibastc. 

First upgrade free, Otherwise send £3 (+£8 for manual if requd). 
Send disk plus SAE or two IRC's 


MKL...£40 (£41/£40/£43) MIKITL...£65 (£66/£63/£67) 


OL REPAIRS (UK only) 


Fixed price for unmodified QLs, excl microdrives. QLs 
tested with Thorn-EMI rig and ROM software 


£27 including 6 month guarantee 


Prices include postage and packing (Airmail where applicable). Prices are: UK (EC,/Europe outside EC/Rest of world). 
UK address, debit card/Mastercard/Access/Eurocard/postal order or CASH! (No Eurocheques). SAE or IRC for full list and details 


OL RomDisq 


Up to 8 mbyte of flash memory for the QL 

A small plug in circuit for the QL’s ROM port (or 
Aurora) giving 2, 4 or 8 mbytes of permanent storage 
~ it can be thought of as a portable hard disk ona card, 
and reads at some 2 mbytes per second. 

Think of it - you could fully boot an expanded QL. 
including all drivers/SMSQ etc off RomDisq at hard 
disk speed with only a memory expansion needed. 


£39 (£41£37/£40) 
£65(£66/£63/£67) 
£98 (£100/£95/£99) 
£3 (£3.50/£3/£4) 


MPLANE 


A low profile powered backplane with ROM port 


A three expansion backplane with ROM port included for 
RomDisq ete. Aurora can be fitted in notebook case and 
powered off single 5V rail - contact QBranch for details. Two 
boards (eg Aurora and Gold Card/Super Gold Card/Goldfire 
fixed to base. Suitable for Aurora (ROM accessible from 
outside) & QL motherboard in tower case. Specify ROM 
facing IN towards boards, or OUT towards hack of case. 


2 mbytes RomDisq 
4mbytes RomDisq 
8 mbytes RomDisq 
Aurora adaptor 


COSthsessedc Sizes eeascenne £34 (£36/£33/£35) 


: I2C INTERFACES 
Connects to Minerva MKII and any Philips PC bus 


Power Driver Interface 16 1/O lines with 12 of these used to 
control 8 current carrying outputs (source and sink capable) 

2 amp (for 8 relays, small motors) ............ £40 (£43/£38/£44) 
4 amp total (for motors etc) £45 (£48/£43/£50) 
Relays (8 3a 12v 2-way mains relays (needs 2a power 
driver) veeccreesecese, £25 (£28/€2 3/£27) 
Parallel Interface Gives 16 input/output lines. Can be 
used wherever logic signals are required.. £25 (£28/£23/£27) 
Analogue Interface Gives eight 8 bit analogue to digital 
inputs (ADC) and two 8 bit digital to analogue outputs 
(DAC). Used for temperature measurements, sound 
sampling (to 5 KHz), x/y plotting... £30 (£31 50/£29/£30) 
Temp probe (-40°C to +125°C) £10 (£10. 50/£10/£11) 
Connector for four temp probes ....... £10 (£10. S0/E10/L115 
Data sheets. ....0....0..cccccccccescceesseesresereaees £2 (£2.50/£2/£3) 
Control software & manual (for all /F).. £2 (£2.50/£2/£3) 


= L SPARES it 


£12 (£12. 50/E12/£13.50) 
vier £3 (£3, 50/£3/£4) 
Circuit diagrams.............. £3 (£3.50/£3/£4) 
68008 cpu or 8049 IPC £8 (£8.50/£7,50/£9) 
8301/8302 or JM ROM or serial lead . £10 (£11.50/£10/€11) 
Power supply (sea mail overseas) ............ £12 (£17/£16/£21) 


Other components (sockets etc) also available 
Payment by cheque drawn on bank with 


19 Dec 98 


Keyboard membrane 
1377 PAL 


29 Longfield Road, TRING, Herts, HP23 4DG 


VISA Tel: 01442-828254 


Fax/BBS: 01442-828255 MasterCard. 


| | tony@firshman.demon.co.uk _http://www.firshman.demon.co.uk 
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The attributes (font etc.) can be 
defined before inserting the 
text, but the ‘Total’ justification 
attribute appears not to work 
at present. The original text for- 
mat is maintained {line and para- 
graph), left-justified: the text did 
not flow to fill the text area as it 
does in 'LINEdesign’. 

Using some of the available 
ext | experimented with the 
various functions. | was able to 
use the block defining feature 
to change fonts and font sizes 
etc. within imported text. | had 
some difficulty in positioning 
he block markers correctly 
because (at 10 point, the 
default) the characters are 
ill-defined on the page and use 
of the ‘View menu which is 
intended to give magnification 
of an area always resulted in 
the programme quitting com- 
pletely. Attempting right justifi- 
cation on a block of more than 
one line always resulted in the 
lowest line only being moved 
to the right margin. 

The ‘Layout’ sub-menu allows 
definition of areas on the page 
for text, tables, graphics, and 
images (only LINEdesign pic- 
tures worked for me, _pic files 
appereared not to be allowed). 
The graphics sub_menu allows 
insertion of simple circles, 
boxes and lines (see 
‘example_parg’). | found that 
the programme became very 
confused if text running to 
more than one page was im- 
ported into a layout with more 
than one text area: Text Area 
#2 seems to take the text 
when Text Area #1 has been 
filled (probably logical but not 
helpful when example — text 
areas have #2 above #1) and 
the second page is nonsense. 
This effect also seemed to 
lock up the programme occa- 
sionally. | managed to format 
my own letter head avoiding 
this confusion by defining a 
single table cell to hold my 
address and telephone number. 


oe 


Further testing seemed to indi- 
cate that ‘insert text’ is sensi- 
tive to the layout defined. After 
loading a simple layout (one 
text area for the page starting 
25 mm from top and ending 15.1 
mm from bottom) inserting 
‘README_first’ produced an 
‘insufficient memory’ message 
in a WARNING window and 
Stalled the programme. A ma- 
chine reset was necessary to 
regain control. 

Of course some of the pro- 
blems | experienced may be 
system related. | use Aurora 
motherboard with Minerva 
ROM, QPLANE, Super Gold 
Card, Hermes, QUBIDE and 
hard disk, Di-Ren keyboard 
interface to AT keyboard, serial 
Mouse, and SVGA monitor 


Finally | wrote of my 
experiences to the author 
Francois Lanciault, sending the 
money to register for upgrades 
(see registrer_txt), by writing 
the letter in ‘Editor’ and 
inserting the text in the page. 
Yes, | am sufficiently impressed 
with ‘PARAGRAPH’ to want to 
have upgrades; the programme 
shows great promise of being 
developed into a very flexible 
word processor for our favou- 
rite computer system. | would 
recommend anyone who uses 
a word processor regularly to 
obtain a copy of vi.01 and 
examine it seriously. | am sure 
that most will also want to 
support this new venture. 


{QL Today will keep you - the 
readers - up to date while the 
improvements on Paragraph 
carry on. The version is free, 
so why not give it a try - and 
if you like it, register just like 
Mr. Bailey did. If you discover 
problems, notify the author so 
that we - the QLers - can 
benefit from a _ bug-free 
wordprocessor as soon as 
possible. - Editor] 


QD98 


Review by Dave Westbury 

We have not included any 
screenshois in this review be- 
Cause we're running out of 
space in this issue - please have 
a look at the JMS advert on 
page 123 for some screenshots. 


Since | bought MasterSpy v1.8 
back in April 1990 it has been 
my favourite text editor | have 
always found it quick, easy to 
use and had just enough faci- 
lities provided for my purposes 
(ie, editing SuperBASIC, As- 
sembler and binary files). Al- 
though | still find it an indispen- 
sable tool for certain things the 
encouraging news on the im- 
minent (dare | use that word) 
arrival of new hardware and 
display drivers prompted me to 
bring myself up to date with 
the current Q(DOS/SMSQ state 
of the art programmers text 
editor QD98. 

Although | had browsed the re- 
views of earlier QD versions in 
lIQLR | have never used QD be- 
fore so this review is very 
much from scratch, my only 
benchmark is the comparison 
with MasterSpy which | am 
very familiar with. Perhaps that 
may well be for the best since 
an article on the new features 
alone would only be of possi- 
ble interest to existing users. 
Be aware that | may be a little 
biased to MasterSpy, no doubt 
my attitude may change in time 
as | become accustomed to 
QD’s way of working. Also 
rather than detail everything 
provided | shall only dwell on 
omissions or enhancements 
over the basics | expect from 
an editor QD98 is supplied as 
two DD disks and a 48 page 
AS manual, the extra disk 
contains the HyperHelp files for 
SuperBASIC. The QD file is one 
of those files which can either 
be EX’ecuted directly or 
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LRESPR'd, the latter option just 
makes it a resident Thing to be 
used when required. It requires 
Menu extensions v7.50 to run 
which are supplied. | found the 
manual easy to get through. 
There are three ways to tailor a 
working version of QD98 to 
the way you wish to use it (ie, 
Assembler, Basic etc). The 
QD98 file can be Configured 
(level 02) to set default options, 
you Can pass parameters in a 
command string when you 
Start a QD98 job and/or you 
can alter the options from 
within QD98 on-the-fly as 
desired. This gives the best of 
three worlds! Of course only 
meaningful options are aval 
lable in each/all situations. 

The command string parameter 
passing is probably the most 
useful since it allows you to 
pop-up customised QD’s from 
its Thing. For example if you 
wish to edit a Basic program 
you can pass the Help direc- 
tory, FiO Thing, Usage and 
‘_bas’ file extension (more on 
those later), similarly for As- 
sembler Unless | missed _ it, 
there is no way to get QD98 to 
automatically remove program 
line numbers before a passed 
filename is loaded and then 
add them on quitting, you have 
to invoke the menu options 
manually within QD98. 

The display is made up of three 
parts: the top part contains in- 
formation and loose items and 
a menubar directly under that is 
an optional Toolbar which con- 
tains icons (picture buttons) for 
popular actions and below that 
is the main text area. The top 
part holds the usual move/ 
resize/sleep items, an info item 
showing the current filename, a 
loose item for toggling insert/ 
overwrite/protect and a ano- 
ther info item which rather 
oddly is updated by a separate 
job. This item contains the cur- 
rent line and column coordi 
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nates along with (when active) 
a flashing disk-save icon to 
indicate that the current file has 
been changed but not yet 
saved. My understanding of 
QPTR/PE is that you can only 
have a dynamic sprite as a 
pointer not as a menu item, so 
this flashing must be done by 
the job, the manual states the 
line/column update is done by 
the separate job to avoid the 
overhead on the QD98 job. 
Similarly, a QD98 reduced to a 
button with unsaved text will 
have a flashing disk-Save icon. 
Initially | found it a bit distracting 
but soon got used to it. A neat 
way of knowing the status of 
your possilbly, precious text file. 


Although | said menubar it is in 
fact just a row of loose items 
which pull down menus group- 
ing similar actions. Some of the 
items within these menus can 
be invoked directly through hit- 
ting a toolbar icon. Other icons 
on the toolbar perform the 
same action as a key (eg, Fi for 
help) or indeed perform actions 
not available elsewhere (eg, 
turn wordwrap on/off). Given 
the limited amount of space 
that a toolbar bar could reaso- 
nably take the icons chosen 
appear to give the best com- 
promise to popular actions. Oh 
yes, | almost forgot, (not really 
Jochen!) if you pause the poin- 
ter briefly over the toolbar icon 
(or indeed any loose item) it 
pops up a little help window to 
tell you what the item does. As 
each item can invoke a diffe- 
rent (though related) action with 
the left or right mouse button, 
the help pop-up even shows 
which next to a little picture of 
a mouse. The pause time 
before the help window pops 
up can be configured or the 
feature can even be removed 
(through a facility provided by 
menu_rext's system wide 
SET_DEFAULT command - OLE 


next? just kidding!). The toolbar 
normally holds 19 icons but the 
last 5 can be replaced by an 
QD98 extension Thing's icons. 
Opting to remove the toolbar 
gives you two extra lines in 
text area. 

The main text area, which is 
the only part which changes 
depth when resizing, only con- 
tains a scroll bar (no arrows), 
even when empty. | also expec- 
ted to get a pan bar when lines 
became/were longer than win- 
dow width, | didn’t. This means 
to get to out-of-window text 
you have to use a cursor or 
cursor combination key. Hold- 
ing down a left/right cursor key 
has the action of wrapping at 
the end of one line to the next 
line, not something |'m used to, 
nor sure if | like. The window 
can be split once only and 
although you can navigate the 
cursor (pointer) to the bottom 
half you are only allowed to 
write to the top half {in fact any 
attempt to leave the cursor in 
the bottom window causes it 
to ‘bounce’ back into the top 
half). | noticed that splitting the 
window had the effect of per- 
forming an undo on the current 
cursor line. 

When loading a file into Master- 
Spy you have to estimate the 
heap size required for the file 
you want to load before load- 
ing it (otherwise it used the 
default). If you didn't give your- 
Self enough room or you had 
been very productive you hit 
this ceiling and had to save 
your work, quit, and start over 
again with a bigger heap. 
QD98 doesn't impose this non- 
sense on you, it just gets on 
with it and reserves memory 
dynamically, a very welcome 
feature. 

The main culture shock of 
QD98 for me has been getting 
used to the ‘fluid’ cursor (per- 
haps that isn't the right word 
but that's what it feels like). | am 
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used to the distinction (under 
the PE) of a pointer or a cursor 
Moving the mouse usually left 
the cursor where it was and | 
got a pointer (ie, the inverse K 
Sprite}, alternately if | held down 
the left mouse button and 
moved the mouse | could for- 
cibly drag the cursor With 
QD98 all that is changed, 
moving the mouse now imme- 
diateley moves the cursor about 
the window until the ‘cursor’ 
pointer goes out of the text 
area whereupon you get an 
arrow pointer As long as the 
cursor iS moving the line/co- 
lumn co-ords stay where they 
were, such that if you chose a 
menu option (by using the poin- 
ter on a pull down) which reaui- 
res a cursor position (ie, to 
insert a character code into the 
file) then it will be to the cursor 
co-ord position you were at 
before you moved the cursor 
with the mouse. Unfortunately | 
couldn't find a key action which 
would put me back instantly at 
the current cursor position if 
didn't take a menu action which 
did, something | would have 
liked under this cursor/pointer 
arrangement, otherwise you 
need to navigate the cursor 
back there yourself (see below 
also). 

Another habit | had to stop was 
moving the pointer into the text 
area and ‘hitting’ it with the left 
mouse button (ie, to ‘hit’ this 
window for keyboard input). 
The left mouse button now has 
the effect of marking the start 
(or end/ insert point) of a block. 
lt would have been nice to 
have had block marking as left 
mouse button drag (as used on 
other systems). 

One of the unfortunate side-ef- 
fects of having a cursor pointer 
is that if you pop up another 
transient program the cursor 
takes the current pointer loca- 
tion on return which invariably 
is not where you left it (ie, 
navigate back again). 
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OK now lets try out some of 
QD98's features. The first test | 
did on QD98 was to try to use 
the program without actually 
having read the manual. 
Nothing is worse than a 
program that has actions which 
are not even remotely intuitive. | 
was happy to find that | could 
do quite a lot, even most of the 
toolbar icons looked their part 
(though the pop-up help soon 
appeared on the ones | 
couldn't fathom). 

All of the line editing keys 
adopt the conventions used 
elsewhere and | had no trouble 
with them apart from the 
ALT+CTRL UP and DOWN 
combinations. | always asso- 
ciate any use of the CTRL key 
along with a cursor key as 
destructive, but QD98 uses 
ALT+CTRL+DOWN to ‘insert’ a 
line under the cursor line and 
ALT+CTRL+UP as sort of undo 
facility (MasterSpy is very flexi- 
ble in letting you define the key 
code for each action available 
if you don't like the default). 

| say ‘sort of undo’ since it only 
restores a line of text to what it 
was when it was out of the 
display window. Useful, but it 
doesn't undo my most common 
mistake of accidently deleting a 
line. (MasterSpy was sorely 
missing an undo facility). An 
elementary word wrap option is 
provided, this is only effective if 
you are typing up to the right 
margin, the word (or rest of line) 
gets put on the next line. If you 
insert or delete in the middle of 
a line it does not reformat; ac- 
ceptable for the use to which 
QD98 is intended (any more 
than that and you sometimes 
end up fighting the auto-refor- 
mat to maintain your layout}. 
Loading a file with the word 
wrap option on does not auto- 
matically break long lines up, 
they get folded at maximum 
line length not (word wrap} right 
margin. 


Backspace (CTRL left) at the 
Start of a line joins the line to 
the previous line but delete 
(CTRL right) does not do the 
same at the end of a line (hmm). 
TABs are treated as soft, spa- 
ces are inserted rather than a 
hard TAB code _ inserted 
(though you can insert an ASCII 
9 code through a menu option). 
This means backspacing de- 
letes the inserted spaces ra- 
ther than the TAB in one fell 
swoop. SHIFT+TAB moves the 
cursor back by a TAB position 
but CTRL+SHIFT+TAB doesn't 
delete back to the TAB position 
(probably just as well, its only 
the ALT key away from a soft 
reset!). You can specify whe- 
ther TABs are stored in place of 
white spaces for saved files. 
Before moving onto the menu 
options | should also mention 
there is a useful cursor move- 
ment action which no doubt will 
be of use to 'C’ programmers 
and its awful syntax. When the 
cursor iS on a bracket charac- 
ter ALT+SHIFT+CTRL along 
with a left/right arrow key wil 
take you to the matching clos- 
ing or opening bracket. It also 
works on the quote marks ' 
and *. 

Some of the following menus 
have options on them that can 
also be invoked through short- 
cut keys (CTRL combinations) 
but they only work if the 
pointer (cursor) is in the text 
window. This puzzled me at first 
as | thought QD98 was ignor- 
ing my CTRL X request to quit 
until | realised this restriction. 
Fl either echoes a file to 
screen or invokes HyperHELP 
(more on that later). 

The F2 File pull down menu 
contains the usual load/save/ 
print facilities expected plus 
something | have always found 
missing in MasterSpy, an insert 
file option. A nice feature is the 
optional maintenance of a 
‘_bak’ file on save. Also on this 
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Files’ menu is an Insert Scrap 
option (global cut & paste 
buffer), | would have thought 
this proper to the F4 ‘Blocks’ 
menu. There is a subtle feature 
when reading/writing DOS/ 
TOS format disks under 
SMSQ/E. QD98 can auto de- 
tect the format and will add/ 
remove CR (ASCII 13) to lines 
on load/save. 

The F3 convention for Com- 
mands is used to pull down the 
menu containing some very 
useful features. You can not 
only ‘Goto’ to usual top/ 
bottom/line/marker but also 
things like Assembler label, 
SuperBASIC PROC/FN  defini- 
tion or even a line containing a 
user-defined label definition. 
The icing on the cake is that, 
for example, if you have loaded 
a SuperBASIC program and 
you choose to goto a DEF 
PROC, you get presented with 
a menu containing all the DEF 
PROC’s found in the file, 
picking one takes you straight 
to it. Although this is a great 
feature it unfortunately discards 
the list after each use, this 
means if there are many items 
you have wait for the list to be 
created each time. 

You can set upto four markers 
(only one could be set in 
MasterSpy) to pinpoint parts of 
the file you may wish to quickly 
return to. The string Search/ 
Replace function usefully al- 
lows to ignore case (Master- 
Spy was case dependent) and 
allows upto four strings to be 
stored for quick reference on 
future searches. (| was glad to 
see QD98 didn't have Master- 
Spy's fatal bug of locking up 
when asked to replace all 
FRED's with NEWFRED, ie, re- 
places on the replaced word...) 
There is an option to delete all 
control codes from a file, of 
limited use, but handy to 
extract meaningful text from a 
foreign format text file. 
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(MasterSpy allows you to strip 
character code ranges which is 
a bit more flexible). 

As with MasterSpy, QD98 lets 
you put any character code 
into a file but unlike MasterSpy 
allows you to pick it from a 
character table (very handy for 
picking out those odd printable 
characters). Because QD98 ap- 
pears to destroy the file inte- 
grity of binary (or executable) 
files it is not possible to directly 
alter such files as you can with 
MasterSpy (ie, poke in new 
changes). In that respect QD98 
iS quite different from Master- 
Spy since you can not index 
the file by byte position (Hor- 
ses for courses: QD98 is good 
for editing source code, 
MasterSpy is good for object/ 
binary code file manipulation). 
Also on the Commands menu 
is the wonderful ‘line numbers’ 
option. Excuse me for a mo- 
ment but I'd like to get up on 
my soap-box and shout “| HATE 
line numbers’, thank you, | feel 
much better now. This, unless 
you didn't know, removes or 
adds line numbers to Super- 
BASIC programs. Up until | 
bought QD98 | used my own 
little program to remove them, 
pass the file to MasterSpy for 
editing and then, on quitting 
MasterSpy, put them back on. It 
would be great if a future ver- 
sion of QD could do this auto- 
magically on loading/saving a 
‘_bas' file. The only argument | 
can possibly see for line num- 
bers is for RESTORE. If we had 
some way of naming DATA 
blocks (eg, DATA_NAME fred, 
RESTORE fred) we could dis- 
pense with them altogether 
(GOTO & GOSUB = 2X81). 
Another very useful command 
on the menu is ‘Order lines’ this 
simply sorts every line in your 
file alphabetically. ie, to get a 
sorted list of extensions cur- 
rently available on the system: 
(from #0) EXTRAS\rami_list 


load it into QD98 and F3 E O. 
There is also a Typing check 
Option but since | dont have 
QTYP | haven't tried it (1 don’t 
have much trubble with my 
spelling, typos - yes). 

F4 invokes the Block menu, be- 
fore | discuss this menu | must 
mention the action of the 
mouse with blocks. The left 
mouse button can either mark 
the start and (then) the end, or 
the insertion point for a block. 
The right mouse button (RMB) 
pops-up a ‘context’ menu {not 
the F4 menu). | was a little 
puzzled at the options on this 
pop-up menu, from it you can 
also mark the start and end of 
a block. What | did expect it to 
have it didn't - ie, copy/cut/ 
delete/paste block options. 
Once you have marked your 
block, to do something with it 
you need to either select an F4 
menu item, hit a toolbar item or 
use the direct CTRL key equi 
valent. | would have thought it 
more useful to replace the RMB 
pop-up menu options for block 
start/end with block copy/de- 
lete etc since this then doesn't 
require the cursor (pointer) to 
be moved or a CTRL key 
remembered. Nonetheless, 
from this RMB pop-up you can 
cancel the block marked 
(which was highlighted in green 
ink), or with the cursor over a 
word, immediately mark the 
word and invoke a search on it 
or get (Hyperjhelp for it. The 
whole line can be stuffed into 
the hotkey buffer from this 
RMB pop-up ‘context’ menu if 
you wish. 

The F4 Block menu is not avai 
lable until you have first marked 
a block, from it you can then 
chose to Forget/Delete/Copy/ 
Move it, Goto Start of or 
Put/Add it into the ‘Scrap. The 
Scrap, aS mentioned above, is 
just the global (system wide) 
cut & paste buffer provided by 
the menu_rext (QMenu) exten- 
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sions. | couldn't find a ‘cut’ 
option, so to perform one you 
need to put the block into the 
Scrap and then delete it, 
otherwise if you don't want to 
alter the scrap the block will 
need to be left where it is 
(marked) until you discard it 
since QD98 doesn't have a 
buffer local to itself | missed 
the handy one-key single line 
cut and paste of MasterSpy, 
you can do the same but 
through two key actions (CTRL 
Z to put a line into the hotkey 
buffer then CTRL down arrow 
to delete the line. But when 
regurgitating it with ALT+ 
SPACE you have to remember 
it is to/from the current cursor 
position unlike the CTRL Z 
cursor-line snapshot). 

There are also a couple of 
other useful things you can do 
with blocks. You can make all 
the characters upper/lower 
case or you can shift the block 
left/right. This latter option is 
very handy because you can 
specify an insert string if you 
move the block right. For 
example if you make the string 
‘REMark’ or ‘/* you~ can 
comment out SuperBASIC or 
Assembler respectively (very 
useful to me). 

Next on the menubar is F5 
Status, from here you can Cus- 
tomise QD98: Margins (though 
not line length - use Config), 
Tab interval, Font, Key-click, 
Toolbar existence, Save op- 
tions (confirmation, _bak file 
creation) and default filing direc- 
tory/file extension. Other op- 
tions provided require more 
explanation: 

'Help file’ allows you to specify 
the current help used. If you 
specify a FILE then this file is 
echoed to the screen when- 
ever you press Fi. If you spe- 
cify a DIRECTORY instead of a 
file then pressing Fl causes a 
different action. QD98 will then 
mark the word the cursor is 
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currently on and then try to 
open a file called ‘help_index’ in 
the specified directory. This 
‘help_index’ file should contain 
a list of words it can supply 
help on along with the asso- 
Ciated file that contains the help 
text for that word. QD98 is 
supplied with suitable help files 
for the SuperBASIC and TK2 
commands such that you can 
get helo on almost any key- 
word. You can add/alter these 
helps files or even create your 
own help index and files. A 
SuperBASIC program is sup- 
plied to help create a As- 
sembler ‘help_index’ file by 
searching for XDEF’s in spe- 
cified _asm file directories. 

‘Tab options’ allows you to spe- 
cify whether QD98 expands 
any ASCII 9 characters found in 
a file to equivalent white spa- 
ces (one or more spaces), also 
if it should try to reduce white 
spaces to tabs on saving the 
file. Upto eight different file 
types (as specified by file 
extension) can have this treat- 
ment done automatically. You 
have to be aware of whether 
your Assembler etc can digest 
ASCIl 9, QDOS & SMSQ/E 
don't like them in SuperBASIC 
program files (many MlS Takes). 
Useful though for reducing file 
size, especially assembler. 
‘Usage’ will, depending on the 
option chosen, highlight certain 
lines in your file (white ink on 
red paper). eg, for Assembler 
any lines marked as comment 
(ie, * or ;) or for SuperBASIC 
any DEF PROC’s lines (though 
the manual states it does the 
same for DEF FN's it didn't 
highlight them). Alternately you 
can highlight lines containing a 
user-defined string {ie, to de- 
limit sections). 

The F6 ‘Word menu offers op- 
tions to interpret a marked 
word as a DEC/HEX/BIN num- 
ber and convert it between 
those bases, it 's slightly limited 


in its use by being restricted to 
16 bits. Another useful feature 
on this menu is being able to 
specify what characters can 
delimit a word (also definable 
through Config). 

Finally the last item on the 
menubar is FiO, this invokes 
action from a Thing that can be 
associated with QD98 when it 
is started) One of the first 
Things | tried was passing 
QD98 the SBAS/QD Thing 
available in SMSQ/E. This al 
lows you to parse and execute 
SuperBASIC programs loaded 
in QD98 [including =unnum- 
bered), | had hoped it could just 
parse the file but it appears it 
always wants to run it as well. It 
would be nice if eventually 
there was also a way of par- 
sing each line as it was entered 
into QD98. 

| also tried the QDasm Thing 
by Oliver Fink supplied on the 
QD98 disk, although there 
were no instructions with it | 
managed to get it to invoke 
QMAC to assemble an ‘_asm’ 
file loaded in QD98 without any 
problem. | imagine there is quite 
a potential for this FiO facility 
and look forward to finding 
more QD compatible Things, 
including how to write one. As 
mentioned above a QD exten- 
sion Thing can add its own 
Toolbar icons if it wishes (they 
then replace the last five icons 
on toolbar which normally ap- 
pear if a Thing doesnt use 
any}. 

Although QD98 comes with its 
own (internal) Fileinfo Thing 
such that executing any non- 
executable files from QPAC 
Files menu will cause them to 
be loaded into QD98 it can be 
disabled through Config. This 
allows Fileinfo 2 to still operate 
with the ability to pass exten- 
ded command string setting-up 
parameters to QD98 for each 
file type (extension) desired. 
The parameters you can pass 


QL foday 


are quite extensive - suffice to 
Say yOu can set up QD98 to 
use template files and even 
pass the printer preamble/ 
postamble strings! 

On the subject of printing, in ad- 
dition to the method of printing 
direct to a device you can opt 
to use a printer driver (filter pro- 
gram under SMSQ/E). This 
driver can be written in Super- 
BASIC or machine code etc, a 
simple EPSON driver example 
is provided in both formats. 
Some standard (translate) keys 
have already been defined and 
are shown in the manual, exten- 
ding or changing them to 
cover different printers looks 
very easy and potentially quite 
powerful. 

The QD98 executable file is 
twice the size of MasterSpy 
vi.8 (65K vs 34K) but packs a 
lot into it (both re-entrant). 
Whilst QD98 was not quite as 
fast at things like multiple 
search & replace it was fast 
enough and more than made 
up for it by offering case de- 
pendency. | couldn't detect any 
difference in speed between 
the two in paging up/down or 
navigating through a file {as 
long as you ignore the lazy 
screen option in MasterSpy - 
which | normally do}. In. the 
short time | have had QD98 | 
haven't experienced any pro- 
blems with it and have happily 
used it to edit 120K Super- 
BASIC and 310K assembler 
files {including invoking the 
respective F10 Things). 

So does QD98 replace Master- 
Spy for me? - definitely for 
source code files, some of the 
facilities available could have 
saved me a lot of time in the 
past. MasterSpy still reigns for 
object file manipulation but will 
now only be used for those 
occasions. AS a endorsement 
of how easy | found QD98, | 
only received it two days ago 
and have used it to write this 
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review (even though It’s really a 
programmers source editor). 
Given the fact MasterSpy cost 
me £30 back in 1990 | think 
QD98 at 125DM is a bargain 
and was money equally well 
spent. (|! have absolutely no 
connection with JMS). 

[Jochen: There are some nice 
ideas which | may pick up in 
one of the future versions of QD 
- my reply will be slightly longer 
so it needs to go into the next 
issue. Just a quick reply to the 
"binary" issue: Don't try to edit 


a binary file with QD - you will 
destroy it QD was never 
intended to edit binaries, and 
the concept does not allow it 
either QD optimises spaces at 
the end of a line, they are cut 
off. It also cuts off empty trailing 
lines. This means, if a byte 
value 32 (Space) happens to fall 
at the end of a line, it will be re- 
moved and the code shifts. 
Deadly for any binary code. 
Maybe a future version of QD 
will check the filetype... 

& 


K-BASE - an easy to use Database 


Darren D. Branagh 


| was recently sent a bundle of 
Disks by our beloved QLloday 
editor (Cheers, Dilwyn!) with a 
view towards me selecting a 
few programs and reviewing 
them, for the hallowed pages 
of our bi-monthly magazine, as 
I've done so many times in the 
past. 

What was quite different about 
this batch of Disks was one 
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thing in particular - they were 
all written by one very talented 
programmer namely Mark 
Knight, from London. 

| have used a couple of Marks 
programs before, namely via 
his excellent Utilities Disk {avai- 


lable from the QUANTA library 
the ALARM program is particu- 
larly useful) so | was eager to 
Load up a few of these pro- 
grams and start playing with 
them. 

Among the disks was a pro- 
gram called KNIGHT SAFE 
(great name, Mark!) which is a 
Hard disk backup utility, another 
prog called Q-PAGE, his UTILI- 
TIES — DISK, 
and an unre- 
‘gistered ver- 
sion of 
~CLIMES, _ his 
stocks — and 
shares simu- 
lation game. 
However, the 
program | 
have chosen 
to focus this 
“review on is 
KBASE, a 
rather nifty 
little data- 


base program. 

On first loading K-BASE, which 
is described as a “Multiple Flat 
File database program’, you are 
presented with a set of neatly 
defined windows (it works OK 
in VGA mode on my QXL with 
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no problems, | might add) dis- 
playing the name of the Pro- 
gram, and the version number - 
2.11 in this case. Pressing any 
key enters the program proper, 
and this is where the new 
defined windows 
come in. “4 
The narrow window 
at the top of the | 
screen iS best de- | 
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scribed aS a COM — 
mand window. [t in- | 
cludes all the neces- 
sary key functions, Le. 
ESC=Quit, — Fi=Info, 
F2=Clock, F3=Com- | 
mands, F4=Redraw, | 
etc. A similarly sized 
window is found at | 
the bottom of the =~ 


screen, and includes Nona: 


tion such as the File Number 
the Filename of the database 
that is currently in memory, the 
filesize in Kilobytes, and the 
number of fields etc. The third 
window, or main window as | 
call it, is the largest, and con- 
tains all the actual database 
information - actually on loading 
K-BASE for the first time, this 
contains Bill Newell, the 
QUANTA Membership Secre- 
tary’s Address and Telephone 
number - as well as a Plug for 
QUANTA. (good — Thinking, 
Markl) 

The program comes with a 
small sample database of 
some 20 records called 
Address_KBF which is useful, 
as it contains the addresses 
of many QL suppliers and 
traders, and you can also use 
this to practice on tool! 
Navigating through K-BASE 
couldn't be easier - for anyone 
who has ever used the 
QUANTA — disk-based _ library 
guide program (LIBGUIDE) it will 
be a doddle, as its almost 
identicall! From the main screen, 
pressing F will present you with 
the first record in the sample 
database. Pressing L pulls up 
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the Last entry: press N for the 
Next one, and P for the 
Previous one - easy or what? 
To go directly to a particular 
entry, press G for Goto - from 
this point, the UP/DOWN arrow 
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keys with move you though 


K-BASE one record at a time. 
Using the arrow keys in 
combination with SHIFT will 
move 10 records at a time, with 
CTRL - 100 records, with ALT - 
1,000 records, and using the 
UP/DOWN arrows with both 
SHIFT and ALT will move you 
through the database 10,000 
(yes, 10,000!!) records at a time, 
though | doubt many of us with 
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need this feature, unless you 


know everyone in the 
Telephone directory! You can 
also press F3 and then F for 
Find, and enter a string to 
search for as a full search 
facility is also provided, along 


with all the usual commands on 
F3 - Load, Save, Delete, Insert, 
etc: 
Creating your own database 
from scratch is also rather easy 
and the program gives you an 
extremely wide variety of 
ways in which to do this. 
. Various options are sup- 
~ ported, such as the ability 
~ to skip any blank fields 
- when printing, to toggle 
the ability to print the 
fieldname either ~— on 
- screen or to the printer 
~ or even both - stuff like 
this is done simply by 
Highlighting an option 
“ ~ with a green arrow, and 
- Selecting it with ENTER 
~ from the F3 (Commands) 


aptior: and by pressing B to 


Begin a new Database. 
When you select B to Begin, 
you are asked for the number 
of Fields you require first, which 
is followed by the names of the 
fields in order which must be 
keyed in, along with the type of 
field you require - Le. is it a 
word, a longword, floating point, 
a cash value, a date, a string - 
will it be in Upper Case, Lower 
case, or a 
Mixture - the 
- choice iS 
- yours. Simply 
_ pressing — the 
~ highlighted let- 
fer in each 
_ case from the 
_ choice of op- 
tions will se- 

lect it. 
' What amazes 
me about 
_ K-BASE iS 
“ that despite 
its obvious 
complexity and flexibility, the 
user interface is extremely 
user-friendly and easy to pick 
up - | took to K-BASE like a 
duck to water, and have barely 
glanced at the manual (supplied 
in Ascit_txt format on the disk) 
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yell! It's So easy to usell 
Another nice feature is the 
ease at which you can load se- 
veral different databases and 
multitask them easily, without 
the need to load two or three 
programs. The number of diffe- 
rent files loaded is displayed on 
the top of the screen, and they 
can be moved between by 
using the F5 {choose File} 
option. Other Features include 
the ability to check and set the 
clock easily by pressing F2, a 
rundown of all the info needed 
about each database you have 
loaded is displayed by pressing 
Fi such as the times and dates 
on which a certain database 
was created and last updated, 
and the method by which the 
database in question is sorted. 
F4 redraws _ {refreshes)the 
screen. 

I've found K-BASE to be easier 
to use than many of the alter- 
natives, such as ARCHIVE or 
FLASHBACK, {The two databa- 
ses | used regularly prior to 
obtaining K-BASE) though 
these programs are probably 
more advanced and there is 
virtually nothing you can't do 
with them, they are difficult to 
use because of this - ARCHIVE 
in particular having an entire 
language of its own. K-BASE is 
quite flexible, yet somehow 
manages to retain its ease of 
use, and as a result, | believe it 
to be the best PD database 
program for the QL, and, unless 
| buy the new version of Data- 
Design soon to go with my 
copy of ProWesS, or the soon 
to be released EasyBase by 
Dilwyn Jones, or MasterBase 
from QBranch, | would use it. | 
would recommend K-BASE to 
anyone - it really is a great pro- 
gram. 


Next Issue, | hope to be looking 
at some newly updated 
adventures by Rich Mellor on 
the QL. Stay Tuned! 

a 
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There has been a lot of talk in 
QL forums about trying to get 
other people to use the QL. We 
all know why we are still using 
after all these years and you 
have all, no doubt, heard me 
state that | still do 90% of my 
work on the QL in spite of the 
fact that | have a 200MHz Pen- 
tium laptop which many would 
regard as a more efficient ma- 
chine. Our main problem here is 
one of expectation and know- 
ledge and that is where there is 
a big division between us and 
other potential users. 


| have recently been trying to 
guide a new user through a 
minefield of problems and that 
has highlit the problems. that 
any new QL User would have. 
One of my customers runs a 
business importing books and 
his whole system is based 
upon several QLs all running 
Archive and a whole suite of 
complex programs written in 
the Archive language. | intro- 
duced him to QPC and he was 
very pleased to find that he 
could use this on a laptop to 
Carry around his whole system. 
He quickly bought a few lap- 
tops for his employees and 
one of those has prompted this 
letter 


This person lives in Canada 
and is PC literate. At first | 
installed the system on his 486 
laptop and this worked fine for 
him except for the speed. 
Some of the long Archive pro- 
grams take up to twenty 
minutes to run through on this 
system! On his next visit to 
England he bought a QL/Gold 
Card/Disk Drives and Monitor 
and took it all back to Canada 
with him. A flurry of calls and 
emails between us showed 


that while he was able to 


handle a PC he was lost when 
trying to set up a QL. Why is 
this? Is the QL so much more 
complex? 


Simple is Not Easy 


The answer, of course, is that 
we have all been through the 
learning curve in small steps. 
We started off with microdrives 
and moved, through a variety 
of interfaces, to 3.5" floppies 
and hard disks. In that process 
we have all learned what we 
needed to know either from 
the magazines, user groups, 
books or just friendly advice. 
We expect a new user to get 
this 15 years of accumulated 
knowledge in a few weeks. 

lf you buy a new piece of PC 
software on either disk (rare 
these days since bloatware is 
increasingly the rule) or CD 
ROM you get a program called 
INSTALL’ or ‘SETUP’ which 
Stores all of the components of 
the program on the hard disk 
and makes changes to your 
system so that you can run the 
new program. This is needed 
for the PC/WINDOWS user be- 
cause the whole tottering edi- 
fice of WINDOWS is not a sin- 
gle program but a synergy of 
small pieces of code all 
Stacked together and_ inter- 
linked so that a wrong call or a 
piece of code in the wrong 
place could bring this all crash- 
ing down around you ears. In 
most cases this all goes fine 
and the system does what you 
expect but disaster is always 
lurking somewhere quite near 
The QL users simpler pro- 
grams which will maybe need 
one or more of the standard 
extensions such as the Pointer 
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Environment, QLIBLRUN © or 
MENU_REXT but can then be 
executed with a simple EXEC 
command if these extensions 
are already loaded. ProWesS 
has been leaning towards the 
PC path with regard to using 
_dil’ files (dynamic link libraries) 
and other similar concepts and 
Steve Hall has been probing 
the concepts of writing an in- 
staller program to set things up 
for people but this whole area 
is one which tends to raise the 
blood pressure of some peo- 
ple. 


"You Are All 


Individuals", "I’m Not" 
(Monty Python's Life of Brian) 
We all consider ourselves to be 
individuals and most of us want 
control of the structure of our 
systems but, for some people, 
the concept of moving from a 
QL with a Gold Card and pair of 
HD or ED drives to a hard disk 
is terrifying and mind boggling. 
It is not that these people are 
stupid, just that they have 
never had to look at a boot file. 
Another of my customers who 
bought QPC (This is the pivotal 
point for many people - moving 
from a QL to QPC often means 
encountering a hard disk for 
the first time and that is where 
you really have to start to think 
about how to set the system 
up) has had a lot of problems. 
He does not want anything too 
fancy here. His son bought him 
a PC to replace his old QL and 
all he wanted to do was to run 
Quill and Archive. The way that 
he had done all of this before 
was to put the disk in the drive 
and reset. Faced with a system 
which could have all of the 
programs on one drive how 
could he select which one he 
wanted? 

These people need a helping 
hand. If we are to retain a user 
base we have to consider 
those who want to do just this. 
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These are the people who 
move to a PC not because 
they want to perform some 
complex task but because the 
QL hardware has left them 
behind and the PC looks easier 


So how do we help out? | am 
open to suggestions here but 
what | would like to see is a low 
cost book which would lead 
these users from the one pro- 
gram per session lifestyle they 
have inhabited to the multitask- 
ing capability which modern 
systems have. Putting this into 
the magazine is no use at all 
because many of these people 
do not read the magazine. If 
anyone has any suggestions 
about this or would like to help 
writing the book contact us at 
Q Branch by mail, fax or email. 


Sometimes | go off the 


rails 

Let us make a comparison. The 
PC is like a train and the QL is a 
small car 

Both will go from one point to 
the other but the train will go 
only from a fixed point to ano- 
ther fixed point whereas the 
car Can go from any point to 
any other and choose its own 
route. In the train you can only 
alter its course by buying a 
ticket to a different destination 
provided, of course, a train is 
going there. The car is steered 
by the user many of which can 
drive over a bit where there is 
no road to get to an unusual 
place. In the train you get a lot 
of messages explaining where 
it is stopping but most of these 
are not understandable. In the 
car you have a set of dials 
which show you that you have 
stopped because you have run 
out of petrol or overheated and 
you Can fix that. 

Sometimes the railway people 
provide the train with a new 
engine to make it go faster but 
then couple another dozen 


Carriages onto it so it still goes 
at the same speed. It could 
Carry more passengers but 
what usually happens is most 
of the carriages are nearly 
empty with each person trying 
to occupy two or more seats. 
In the car you can decide who 
your passengers are, OK you 
may have to travel somewhere 
with a cranky old relative or an 
obstreperous teenager once in 
a while but in the train you may 
settle down with a good book 
in a half empty carriage only to 
be invaded by a bunch of foot- 
ball hooligans one of who is 
bound to pull the communica- 
tion cord and stop everything 
for a while. Of course you may 
never find out which one pulled 
the cord and each one blames 
the other If the same thing 
happens again on the same 
journey it is always someone 
else who does it. 


The railway people also like to 
paint their carriages with many 
different colours and logos but 
most of us are quite happy to 
have our Cars painted in just a 
few. 


A car will use a small amount of 
fuel but that is used to travel to 
the places it has to go to. A 
train will need a large amount of 
fuel which will all be used up tf it 
is full of passengers or empty 
because its system makes sure 
that it will always go from the 
starting point to the end point 
and stops at all the points in 
between regardless of whether 
anyone wants to get on or off 
it. This, for the car is like driving 
to the supermarket and not 
getting out because the larder 
is still full of food from last 
week. 

Trains can go much faster than 
cars but often stop with a lame 
excuse which is usually not 
something you can easily 
understand. ("Leaves on the line 
have performed an illegal ope- 
ration and will be closed 
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down’). Cars do get caught in 
traffic jams but you can often 
find a way around them. Trains 
go on strike, cars don't. 


For most people, using a train is 
just spending a lot of money on 
a ticket and being taken for a 
ride in uncomfortable circum- 
stances with long waits at each 
end and at some points in bet- 
ween. lo use a Car you have to 
learn something, practise and 
then take a test. 


A Dutch Treat 


The last Eindhoven meeting, in 
November was one of the 
most active | have been to. 
Tony Tebby was there demon- 
Strating the latest develop- 
ments in the SMSQ/E system 
for the Q40. Although this ver- 
sion of the operating system 
had no floppy or hard disk 
support at the time it was still a 
very rapid piece of code and 
the best part of this was Tony's 
evident enthusiasm for the 
project. In many ways it was 
this obvious keenness that led 
TF Services and | fo make a 
joint agreement to build and 
sell the finished item. TT said 
he would give this priority 
because he wanted to be able 
to use a Q 40 for his own 
development work and there 
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could be no better indication 
that the job would be finished 
quickly. There were quite a few 
people at this meeting and Per 
Witte joined the illustrious ranks 
of those who bought all the 
componenis and built his Auro- 
ra system on the spot. | would 
like to see more of this at 
workshops because it demon- 
strates the spirit which has 
kept the QL going over all of 
these years. 


Joachim van der Auwera was 
also there talking about his 
plans for the future of the Pro- 
Wess system. He too was very 
interested in buying a Q40 and 
had some very good concepts 
for the next generation of Pro- 


The view from the hotel in Croatia 


WesS. After the show we all 
went to the usual Chinese 
Restaurant and thence to a 
local bar to talk over all things 
QL. 


There's Snow Business 
It was never going to be an 
easy journey but it could have 
been worse. | set off to meet 
Tony Firshman at Dover and 
got brought to a complete 
standstill on the M25 as the 
result of an accident. Time was 
tight for the ferry but we made 
it - just. Our normal ferry jour- 
neys to foreign QL shows are 
taken up with a leisurely meal in 
the ships restaurant but Sea 
France does not provide a 
vegetarian option in their res- 
taurant so we were forced into 
the self service buffet in which 
Tony got into an argument with 
the ‘chef (well he had a tall hat - 
and probably a pointed head) 
about not having Ratatouille on 
his steak (| am the veggie not 
Tony). 

Ah well it could have been 
worse. 

Off the ferry and | took over 
the driving duties to head off to 
pick up Jochen. Barely 1 hour 
into the drive | was overtaking 
a truck when the car took on a 
life and direction of its own. 
Black Ice. We performed a neat 
imitation of the Waltzer for a 


minute or two and wound up 
going backwards into the crash 
barrier at around 40 mph. 
Having ground to a halt Tony 
looked up with a sigh of relief 
only to see the truck baring 
down on us. Crash! The truck 
hit the passenger door and 
Spun us around - well we were 
facing the right way now at 
least. We got out and begun to 
inspect the damage but soon 
became aware that vehicles 
were spinning to oblivion. all 
around us. When a large truck 
hit the crash barrier just a few 
yards from us we decided that 
this was the time to go and 
park somewhere safe. 


Well it could have been worse. 
The damage was bad but not 
so bad that we could not con- 
tinue. Tony rewired the rear 
lights with a superHermes LED 
cable and we carried on to 
Jochen. At this point, we were 
using Tony's map and travelling 
up through Maastricht. He kept 
saying "This road is not marked 
on the map”. We finally picked 
up Jochen and headed off to 
get Marcel Kilgus from Stutt- 
gart. One useful item came 
from Jochen’s house - we took 
his shaving mirror and taped it 
to what was left of the nearside 
wing mirror sO we could see 
behind. 


The journey down to Marcel 
was OK and from there we set 
off towards Munich and into the 
SNOW. 


Well it could have been worse. 
The snow started just outside 
Munich and gradually got 
worse aS we headed towards 
Austria (why was | not sur- 
prised?) and it was then that 
we discovered why some 
roads were not marked on 
Tony's map. Jochen noticed 
that the map was older than he 
was! This is when we had our 
next brush with automotive 
disaster Just aS we were ap- 
proaching the Austrian border 
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the car ahead stopped dead. | 
applied the brakes but, with 
four people and a carload of 
QL stuff were a bit heavy and 
we carried on going until we 
were around six inches from 
the stationary vehicle - when 
we stopped. 


Well it could have been worse. 


Nasta’s directions said that we 
should follow signs for Graz 
and avoid Villach. This avoided 
the most expensive of the toll 
tunnels and roads but it did 
take us through the mountains. 
Now think, what do you find in 
mountains? Ah, yes, more 
snow! It was all very pretty but 
it was getting dark and snow- 
ing quite a lot. Tony seemed to 
have got the situation sussed 
out though because he 
managed to take his driving 
spells when it was not snowing 
too badly. As soon as | took 
the wheel it was Polar Expe- 


the Frank Zappa song ‘trudging 
across the tundra, mile after 
mile’ but finally we made it 
across Austria and into Slo- 
venia. Hallucinations must have 
set in at this point because | 
thought | saw a giant Starship 
Enterprise style spaceship 
hovering over the town. It was 
just. an illuminated ski slope 
Slovenia was a short ride (com- 
paratively) and we were finally 
at the Croatian border Nasta 
met us there and we joined a 
queue of traffic which was 
crawling through the border 
post. All of the others had been 
Shut down due to snow so this 
was the only one open. 


Well it could have been worse. 


By midnight we were sitting in 
a restaurant in Samobar with 
Nasta and Drazan enjoying 
much needed food and drink 
before we staggered off for a 
good sleep. The next day 


dition time. 

Well it could have been worse. 
Hunger had set in by this time 
and all the odd food was 
coming out. Musli bars and 
spicy pepperoni were being 
passed around (| ignored the 
latter). Every time we saw a 
McDonalds sign Jochen's eyes 
lit up but we would not stop. | 
kept thinking of the line from 


when we looked out of the 
window, it was obvious that 
many of the potential visitors 
were not going to make it 
because the snow lay deep 
and crisp and even. 

When we unloaded the car 
Tony discovered that, in our 
haste to leave the scene of the 
accident, we had left a box 
containing all Bill Richardson's 
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stock and some of his super- 
Hermes and RomDisqs by the 
motorway. 

Well it could have been worse. 


We set up in the main room 
and, despite the weather the 
Austrian contingent managed 
to turn up. It was quite a quiet 
day, however, so Tony Firshman 
and Nasta put it to good use by 
looking into the reasons why 
RomDisq will not work with the 


talking over new projects for 
the coming year After the 
show we adjourned to another 
restaurant to eat and prepare 
ourselves for the long journey 
home. Many thanks to the 
Hotel for providing us with 


sandwiches for the return 
journey. 
As we retraced our steps 


through Slovenia and Austria 
the snow got steadily worse 
with the usual brief respites 
when Tony was at the wheel. 
After a pause for lunch in 
Austria we began to run into 
more and more snow until, 
around Munich, it got so bad 
we were down to 40 mph and 
we could not see where the 
road was. All this time we were 
overtaken by trucks and other 
cars at silly speeds. Jochen 


Qubide and Gold Card and 


listened nervously to the radio 
traffic reports many of which 
spoke about a Rutschpartie 
auf der Autobahn’ (sliding party 
on the motorway). — Traffic 
queues were getting longer all 
around us but somehow we 
seemed to be able to avoid the 
worst of them. 


Well it could have been worse. 
We dropped Marcel off at 
around 11.00pm and headed up 


to Jochen’s house. More snow. 
At 4.00 am we pulled up out- 
side Jochen’s house and, with 
great sighs of relief, accepted 
his hospitality for the rest of the 
night (Many thanks to Jochen’s 
parents). After breakfast we set 
off for home but we had to 


stop at Brugge to report the 
loss of the stuff on the motor- 
way. They told Tony that 7 
people had died in the accident 
that we were in so we made 
the right decision to leave 
when we did. When | logged on 
to the internet the next day 
Jochen had sent me news of 
what had happened on the 
roads. Apparently, just after we 
had got through, 1 metre of 
snow fell on the very road we 
had gone down to drop Marcel 
off There had been many mul- 
tiple pile-ups on the road that 
we had been on but luckily we 
nad managed to get through 
without them. In the worst of 
these a coach had collided with 
a car and then been hit by a 
truck load of bottled mineral 
water broken glass and 
frozen mineral water all over 
the road. 23 people died on the 
roads that weekend and it was 
the worst December weather 
in Germany for 50 years. 

Well it could have been worse. 
| apologise for taking up so 
much of my column with the 
Croatian journey but it was 
pretty eventful and at least | 
was not complaining about file 
names this week. 

| wish you all a Happy New 
Year 

a 


Eindhoven QL Show - St. | oris College 
‘Saturday, 30th of January 1999! Don’t miss it! 


Sussex User Group / Quanta Workshop 
Sunday 28th February 1999 - 10am till 4pm 


The Fourth Sussex User -———— 
Group / Quanta Work- 
shop will be held in the 


Excelsior Hotel on Excelsior Hotel - tel 01273 - 773991 | 
Sunday 28th 205 - 209 Kinsway, Hove Sussex 


February 1999 | | 
There will be talks, | oe 
demonstrations, a "Bring | 


& Buy stall, traders and | 
users. Hove Stato 
Come along and see all saute ton’ 

types of QDOS/SMSQ 

software and hardware 

in operation. Cheaper alta te 

rates are offered for the | | | rod | wl 
weekend at the hotel if | Ml 

you quote Quanta’ when | a 
booking a room. West er 
All this and a day by the | King Alfreds 
sea too - how can you | SE A ae re 
resist? 


Two US-Shows in one go! Unique chance! 


| US QL-East Coast Show 29-30 May AGENDA: 
| The show will be at Wesley Hall, St Andrews United FRIDAY night 6PM till ? dinner at Cobblestone Restaurant. 


| Methodist Church, in Spring Lake, NJ, about 60 miles south SATURDAY 9AM to 4:30PM Vendors, Tutorials, and Workshops. 
| of New York City. QL-East will include vendors, work shops, Fee per family is $10 if paid by 1 May, $12 at door Fee includes light 
| and some interesting tutorials by Bill Cable, Herb Schaaf, and lunch and coffee/tea throughout the day. SAT. EVE. 6-9 PM Banquet, 
| Simon Goodwin. The show includes other Sinclair compters, panei discussion, and entertainment. $20 per person. Late nighters 
| TS-2068, 7X81 etc. A block of 20 rooms are available at ‘elreat to Bar and Grill SUNDAY 11AM al McKelvey’s home there will be 
| Budget inn, te:732-775-7200. To obtain the show rate of $50 additional tutorials and informal discussions. Includes light lunch and 
| per night for 1 or 2 people for Friday and Saturday, mention beverages free. 

| the OL Show and make reservations by 1 March. Pay advance fees to show treasurer: Bob Mailoy, 4}? PACIFIC 
i Spring Lake is a seaside resort area about 75 minutes from ST.MASSAPEQUA PARK, NY 11762. Overseas attendees may obtain 
| airports at Newark, Atlantic City, or Philadelphia. It's about 2 advance rate by notifying Bob bmalloy@idt.net and paying after arrival 
| hours from JFK airport. Local information including (probably Questions about the agenda should be addressed to Al Boehm 
| free) transportation from JFK, can be obtained from Local boehm@ziplink.net Updates will be added to the NESQLUG web 
| Host Bill McKelvey: Email MCKELVEYW@delphi.com page http://www.airnet.net/boehm 


Note there is also a QL West Coast Show the following weekend! (More details next issue) 


